Toolbar Tips and Techniques 



www.wdi.com 


Windows 


The Magazine for Windows Programmers 

jommunjcations/Networks 

Easy Internet Copying with wininet.dll 
RPC Tips and Tricks 


November 1996 

Volume 7, Number 11 


x 


l 


orland's New Object-Oriented Design Tool 
ompiler Benchmark: Iterators 


Bug++ of the Month 
The Visual C++ delete[] Bug 
Tech Tips 

cwd versus Long Filenames 
Understanding NT 
More NT Service Techniques 
Books in Brief 
Networking Books 









1 - 800 - 374-4353 


InstallShield Corporation 


□ Request Reader Service #100 □ 


OTHER OF ALL 


HAD A SON. 


Introducing InstallShield Express 
Professional. The fastest way to 
create software installations 
without writing code. 

InstallShield Express Professional is the latest 
addition to the InstallShield family. With its birth, 
you can create professional 
setups by just pointing 
and clicking. Simply 
answer the InstallShield 
Express Professional 
questionnaire and your 
installs are created right 
before your eyes. 

It's that fast. 

Designed for use on 

. , , Supports Visual Bosk? 4.0, Delphi” 2.0, 

32-brt systems, InstallShield vwaic+*4.i.Borhnd‘c++s.oand 

Paradox 7. 

Express Professional allows 

you to build installations for use with either 
Windows 3.1 or Windows 95/NT Among 
so many other things, you can display 
custom bitmaps, create icons and modify 
the .INI files or registry.There's even a 
feature that helps create your own unin¬ 
stall facility. Try the quick and easy way to 
deploy applications - InstallShield Express 
Professional. It's smaller and faster; but just 
as dependable as Mom. 

Download a FREE fully functional evalua¬ 
tion copy of InstallShield Express today 

ttion to all Windows* 

°SsK°" www.installshield.com/express 
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Tired 


of low returns on shareware distribution? 


Looking 


for an effective way to show off your products to more potential customers? 


Thinking 


about using the Internet to distribute software? 


Show your stuff with 



The Demo Builder for Windows 


New Version 2.0 
now includes the TrialWizard! 


Designed for use with timeLOCK!, the TrialWizard" 
instantly creates trial session profiles for your product— 
encrypted, secure and packed full of custom information. 


—the most useful demo tool around! 


So many uses: 

• Online demos 

• Electronic brochures 

• Sales presentations 

• Disk-based advertising 

• Tutorials 

• Interactive demos 

• Self-running demos 
...and more! 

So popular: 

PC Magazine said, “When you can't 
be there to demonstrate a program 
yourself, Dan Bricklin's demo-it! 
makes an effective stand-in.” Windows 
Magazine said, “Windows evangelists who want to spread the 
word with a touch of flair can hardly go wrong with this powerful presentation tool." 
And InfoWorld Magazine calls demo-it! “a first-rate tool with a variety of uses.” 



So easy to use: 

Version 2.0 includes all of the easy-to-use demo-it! features introduced in the original 
version of this widely acclaimed demonstration tool, plus these enhancements: 

• Rich Text (RTF Format) • Variables 

• Heartbeat Clock • Simulated Typing 

• Filmstrip Animation • Object Sets 

• Scaling Bitmaps • Revised User Interface 

• Additional Transitions • Finer Timer Control 


timeLOCK! 

The Ultimate Trialware Tool 



.» Dan Bricklin': 


A.*2qn Bric kJiny 

nmeLOOcr 


tome visit the timeLOCK! 
htt„ ?f VeloperWeb siteat 

http.//www.timelock.c 


• Opens the door to new 
distribution channels. 

• Ideal for sales lead fulfillment, 
direct mail promotions and 
Internet distribution. 


One by one, developers are making their 
applications ready for online distribution. Over 
12 million potential customers are cruising 
the Internet looking for good software. They 
demand to “try before they buy.” They don’t 
want crippled-ware, locked files or canned 
demos—and you don’t want to give away your 
software as shareware. So, how do you do it? 
Say hello to Dan Bricklin’s timeLOCK!... 


The ultimate trialware tool! 

• Creates fully functional "timeLOCKed" 
versions of Windows® software. 


• Converts to full-time operation (“untimeLOCKing”) only when user pays for license. 


Greater control—and easy to use! 

With one function call, Dan Bricklin's timeLOCK! allows potential customers to evaluate 
your fully-functional program for a period of time. Set the trial period and timeLOCK! 
takes care of everything else. 


Product 


Product No. 


Price 


demo-it! V2.0.LIDSD3FZ .$399 

timeLOCK! V2.0 Lite Developer's Kit for 16-bit applications.LITLL3 FZ .$199 

timeLOCK! V2.0 Lite Developer's Kit for 32-bit applications.LITLM3 FZ .$199 

timeLOCK! V2.0 Pro Developer's Kit (extendedAPI set, 5 trial types, custom dialogs) 

for both 16- and 32-bit applications.LITLN31 FZ.$699 

timeLOCK! V2.0 additional keycode module for telemarketers.LITL031 FZ.$499 

(Both the Lite and the Pro products come with one Keycode Module for unlocking—additional keycode licenses may be purchased separately as indicated above) 

Ask us about unlocking services available from Lifeboat. 


CALL & ORDER TODAY! 

800 - 987.4929 

1163 SHREWSBURY AVE. • SHREWSBURY, NJ 07702 • VOICE: 908/389-0037 • FAX: 908/389-9227 • BBS: 908/389-9783 
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PUBLISHING 


THE POWER TO DEVELOP YOUR IDEAS 

Don Bricklin's is a registered trademark of Daniel S. Bricklin. demo-it! is a registered 
trademark of Lifeboat Publishing. Windows is a registered trademark of Microsoft 
Corporation. timeLOCK! and TrialWizard ore trademarks of Dynasoft Publishing Corporation. 
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RPC is a powerful technique, but not the easiest new Win32 feature to use. This article 
shows you some of the pitfalls to look out for, and provides some reusable code to solve 


some common problems. 

Mitch Stuart 

Internet Downloading via wininet.dll . 19 

wirinet.dll is Microsoft’s attempt to provide a high-level interface to the Internet. Here’s 
an example of using the new DLL to copy files to your hard disk from any URL. 

Sven B. Schreiber 

Compiler Benchmark: Iterators . 35 


C++ iterators encapsulate the work needed to enumerate or traverse the members of 
some collection of data. Encapsulation is nice, but you will pay for it with slower execution 
if your compiler does not do a good job of optimization. Here’s how five compilers scored. 

Ron Burk 

Borland’s Design Tools 5.0. 39 

Borland C++ 5.0 has been out fora while, so what’s this new “Borland C++ Development 
Suite with Design Tools 5.0”? It’s a mouthful, but what it mainly means is that Borland has 
bundled an integrated version of Together/C++ to create a new, high-end package. Here's 
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How can you pass parameters to your service, especially if it starts up before anyone 
logs on ? Why doesn’t your service stop when you log off? How can your service detect 
when the user logs on or off? All these reader questions and more are answered in this 
month’s look at NT service issues. 
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Internetworking with TCP/IP, Volume III, 2nd Edition, by Douglas E. Comer and David L. 
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Let's face it - when you need a disassem¬ 


bler you're looking for clear, reliable informa¬ 
tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov 

ax,2517h 



dx.offset int 17h entry 


int 

21 h 

; DOS Services ah=function 25h 
; set intrpt vector al to ds:dx 
(’Halt when ? printed.') 

mov 

dx.offset data 4 

mov 



int 

21 h 

DOS Services ah=function 09h 
display char string at ds:dx 

mov 

dx,19h 


mov 

ah,31h 


int 

: DOS Services ah=function 31 h 


; terminate and stay resident 
al=return code,dx=paragraphs 


virustst endp 




int_17h_entry proc 
pushf 

far 

Push flags 

cmp 

al,3Fh 



Partial Disassembly of a Virus 


C/C++ and Pascal 

Some C, C++ and Pascal developers hate 
disassembly because the source code they get is 
assembly. We can't change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 

The BIOS Pre-Processor creates commented 
listings for any BIOS ROM. Understand how 
your specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Inserts labels 
like"int_10_video”. Andit’sfully automatic. 
Windows disassembly! 

Windows Source generates detailed listings 
of Windows EXEs, DLLs, VxDs, device 
drivers, & OS/2 NE files. Windows Source 
labels, by name, export & import function calls, 
API calls like "GetModuleHandle”, undocu¬ 
mented APIs, VxD functions and much more. 

Call now! 
1 - 800 - 648-8266 



From the Editor 


I haven't had a chance to check it out yet, but reader Mark Hammond sent me a 
note about an interesting piece of software called Python. Interpreted, object-orient¬ 
ed, and apparently he's written an extension that lets you interactively make MFC 
calls! Could be a less painful way of figuring out Microsoft's application framework 
du jour, http://www.python.org/ftp/python/pythonwin. at Okay, this Web stuff is 
getting downright creepy. I noticed the other day that readers can see the next 
month's cover shot on our Web page before I get to see it myself! Of course, I do 
work several hundred miles from where the magazine is produced, but still... Pretty 
soon. I'll meet myself coming and going on the Web. AT Most of our authors are nice 
enough to include their email address in case readers have questions, compliments, 
comments, etc. Most reader mail is interesting and informative, but there are several 
things our authors can't do, and at the risk of being very obvious, here's a short list: 
They can't get you free back issues. If you need articles or issues that have appeared 
previously, hop over to our Web site at www.wdj.com for ordering information. They 
can't debug your program for you or answer general Windows programming 
questions. Our authors are invariably programmers with full-time jobs who use 
their scarce spare time to contribute articles. For questions not specifically related to 
something one of our authors wrote, try a general online forum such as Usenet or 
CompuServe. They can't get you Bill Gates's email address. Or Larry Ellison's, or 
the latest beta software, or stuff like that. We like our authors to list their company 
name to avoid the appearance of hiding any potentially relevant industry connec¬ 
tions, but if you've ever worked at a big company, you know that sending email 
requests to a random employee of Company X is more likely to be annoying than 
productive. By the way. Bill Gates' address is billg@microsoft.com. I know this 
sounds insane, but there are a few people out there who still imagine he reads all his 
email and is anxiously awaiting their input, if only they knew the correct address. 
AT Looking for your next contract or job? Our Web site runs ads from folks looking 
to hire programmers, so you might want to check www.wdj .com periodically. We also 
have some pages devoted to helping you find the development tool you're looking 
for — check it out and tell us how we can make it better, at It's been a while since I 
picked up a new tool that was both fun to use and really made me more productive 
in narrow range of programming tasks I perform. That's what happened when I 
checked out the new high-end bundle from Borland, though. The new integrated 
version of Together/C++ (from Peter Coad's company) has put the fun back in 
object-oriented design for me. Lots of rough edges and plenty of room for improve¬ 
ment, but check out the article on page 39 this month for more details — if you spend 
much time doing C++ class design, this could be for you. AT Tired of dialing in at 
28.8K? Thinking of plunking down some bucks and moving to ISDN? Me too, so I 
went to the bookstore and managed to spend $200 on ISDN books in 15 minutes. 
Watch for the reviews in an upcoming issue. 


Sourcer $149.95 

Sourcer & BIOS Pre-processor 189.95 

Sourcer & Windows Source 249.95 

Sourcer, BIOS & Windows Source 289.95 

Shipping: USA $6; Canada/Mexico $10; All others $25. 
CA residents add sales tax. © 1994 VISA/MC/Amex/COD 

30-DAY MONEY-BACK GUARANTEE 



V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 120-WD 
San Jose, CA 95129 408-296-4224 
FAX 408-296-4441 


Ron Burk 

Editor 

70302.2566@compuserve.com 

http://ourworld.compuserve.com/homepages/RonBurk 


Drop in on our Web site! 
You’ll find us at: 
http://www.wdj.com 


You’ll find information and 
excerpts from the current 
issue, along with links to 
WDJ code, including our 
SDK Annotations. 

Check it out — and let us 
know what you think. 
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Visual Internet Toolkit 


Save months of TCP/IP programming! 


Fill in properties 




it 

Write a little code 




Object jCoMtandl 3 *** |5ck 

-MxJ 

Private Sub Couaandl_Cliclc() 

T 

FTPClient. Action - ACTICMCCMNECT 


• Transfer Remote Tile to your machine 


End Sub ” ~ 


uu 


OLE Custom Controls 

Just ask any OCX jockey. With Distinct’s Visual Internet 
Toolkit, adding TCP/IP connectivity to your application 
is not much farther than a drag-and-drop away. 
Whether you need a customized FTP client or most 
any other Internet application, you can simply embed 
an OCX into your program and Visual Internet 
will do the rest. It’s that easy. And you’ll have 
great looking, powerful applications. 


Protocols 

• Windows Sockets 

• Telnet 

• TCP/UDP/ICMP 

• VT 220 

• PPP/SLIP/CSLIP 

• WinSNMP 

• E-mail/SMTP 

• ONC RPC/XDR 

•POP 2/POP 3 

• rep 

• News/NNTP 

• rexec 

•FTP 

• rlogin 

•TFTP 

• rsh 

• TCP Server 

• And many more 

Interfaces* 

Environments 

•32 bit (95 and NT) 

• Visual Basic 

• 16 bit (Windows 3.x) 

• Visual C/C++ 

• C++ Class libraries 

• Delphi 

• DLLs 

• C/C++ 

• OCX’s 

• Access 

• VBX's 

• FoxPro 


32 Bit Performance 

The power of our new 32 bit Visual Internet Toolkit 
is simply unsurpassed. More custom controls. More 
protocols. More sample code. More Documentation. 
Which makes your job easier and leaves the 
competition in the dust. 



u 408.366.8933 


World Wide Web: http://www.distinct.com 
Fax: 408.366.0153 

E-mail: windev@distinct.com 

Fastfacts: 408.366.2101 


•Nol aO interfaces may be available for all protoarfs. UcensiDg fee required for redistributioa Distmct is a registered trademark and 30 minule bMemet Delivery! and Visual Internet is a trademark of the Distinct Corporation. Copyright 1995 Distinct Corporation. 12900 Saraoga .%enoe. Saratoga, CA 95070. AD rights reserved. Spedficalions and ddivery terms are subject to change without notice. 
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Communications/ 

Networks 



RPC Tips and Tricks 

Mitch Stuart 


Remote Procedure Call (RPC) technology can be a very useful tool in implement¬ 
ing client/server and distributed applications. The intent of RPC is admirable: to 
make the "remoteness" as transparent as possible so that a remote procedure call can 
be written as simply as a local one. Unfortunately, if you are developing RPC pro¬ 
grams, you will quickly find out that using RPC opens up an entirely new set of con¬ 
cerns — everything from learning a new set of APIs to handling a new batch of net¬ 
work and RPC runtime error conditions. 

In an attempt to lessen some of the mystery and complexity surrounding RPC, 
this article presents a series of tips and techniques for using RPC more effectively in 
your programs. The tips are varied enough so that both beginning and experienced 
RPC programmers should find something of interest. Although this is not a tutorial 
on RPC, the text contains pointers to sample code that will get you to the point 
where you can use the information provided here. 

The first set of tips covers RPC installation, sample programs, bindings, and the 
RPC Name Service. 

RPC Installation 

There are two important sets of RPC files: those needed to run RPC programs and 
those needed to develop RPC programs. 

The Microsoft RPC runtime files are automatically installed during the installa¬ 
tion of both Windows NT and Windows 95. (A separate installation is required for 
Windows 3.x; only the Win32 versions will be covered here.) Although the bundled 
RPC runtimes are Win32-specific, they do comply with the Distributed Computing 
Environment (DCE) standard, so that your programs can interoperate with other 
vendors' implementations of DCE RPC. 

How you install the RPC development files depends on which compiler you are 
using. If you are using Microsoft Visual C++ version 4.0 or later, then the necessary 
header files and import libraries are included with the compiler and you will find 
the RPC sample programs on your CD-ROM in the directory 

\msdev\samples\sdk\rpc 

If you are using a pre-4.0 version of Visual C++, then you will need to sepa¬ 
rately install the Win32 Software Development Kit (SDK). The RPC samples are in 
the directory 

\mstools\samples\rpc 

Finally, if you are using a non-Microsoft compiler, you may or may not need to 
install the Win32 SDK, depending on what your compiler vendor has licensed from 


Mitch Stuart has been developing software in Silicon Valley for 10 years. He is cur¬ 
rently a development manager at Centura Software Corporation (formerly Gupta 
Corporation); however, the opinions expressed here are his own. Mitch can be contact¬ 
ed at mitch.stuart@centurasoft.com. 
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This Is Your App... 




This Is Your App with MapObjects... 



isui *i 


Code 


Ac court 

Check 

120188 

120323 

152125 

3542798 

120013 

120323 

152126 

3542788 

120229 

•2C3K 

152155 

3542787 

119494 

120340 

152156 

3542793 

120227 

120350 

152168 

3542863 

120219 

120362 

152183 

3542803 

120102 

120362 

152184 

3542803 

120340 

120393 


3542784 


a* t* i;— '** 




Ifrl orlor 




MapObjects™ is a collection of mapping and GIS components consisting of an ActiveX™ control (OCX) 


With MapObjects, 

users can 

• Pan and zoom 
through multiple 
map layers 

• Display data using 
classifications, 
graduated symbols 
labeling, and dot 
density 

• Display a variety of 
image formats 

• Use relational 
databases and SQL 
queries 

• Perform spatial 
analysis and query 

• Perform address 
geocoding 

• Track real-time 
events (GPS) 

Plus: 

Lots of data 


and a collection of over 35 programmable ActiveX automation objects. MapObjects is by far the largest 
component library of GIS software. With very little programming time you can add dynamic, live maps 
and GIS capabilities to your applications. You can use MapObjects with popular programming environ¬ 
ments such as Visual Basic®, Delphi®, PowerBuilder®, and Visual C++. 


including streets, 
census boundaries, 
ZIP Codes, states, 
countries, and 
much more 


Because MapObjects is from ESRI, you can be assured you are getting industry-standard, technologically 
superior mapping and GIS functions. That’s because ESRI is the world leader in digital mapping. We have 
built our reputation by making mapping software that helps you accomplish tasks faster, easier, and better. 



MapObjects 


Put a Map in Your App 



1 - 800 - 447-9778 

Fax: (909) 307-3051 
E-mail: info@esri .com 
Web: www.esri.com 

International: (909) 793-2853, 
extension 1235 


Copyright © 1996 Environmental Systems Research Institute, Inc. All rights reserved. ESRI is a registered trademark; MapObjects, the ESRI globe logo, and the MapObjects logo are trademarks; and 
0esri.com and www.esri.com are service marks of Environmental Systems Research Institute, Inc. Other companies and products mentioned herein are trademarks or registered trademarks of their 
respective trademark owners. 


□ Request Reader Service #105 □ 








































































Microsoft. Check your documentation for references to RPC 
header files, libraries, or samples, but be prepared to install 
the SDK in case you don't find any. 

Building the RPC Samples 

Once you have the proper files installed, the best way to 
begin learning and using RPC is to build and run the sample 
programs provided with the compiler or SDK. Each sample 
directory has a readme file and a makefile. To build a sample, 
simply switch to the directory containing the sample you wish 
to build and type 

nmake 

I encourage you to concentrate on two sample programs at first: 
hello (in rpc\hello) shows the basics of using RPC without 
using the RPC name service, and nhello (in rpc\ns\nhel 1 o) 
introduces the name service. 

RPC Bindings 

If you run the client program from the hello example 
(hel 1 oc. exe) with a parameter of - ?, you will get (in part) the 
following "helpful" output: 

-p protocol_sequence 
-n network_address 
-e endpoint 

The program is prompting you for the information it needs to 
create an RPC binding handle. An RPC binding uniquely 


identifies an RPC connection by encapsulating the above three 
pieces of information. The protocol sequence represents the 
underlying network protocol used to conduct the session (for 
example, TCP/IP, SPX, NetBIOS, etc.). The network address is 
the address of the computer running the RPC server program 
you wish to communicate with. The endpoint identifies the 
specific instance of the server program to connect to. 

What makes all of this a little complicated is that the format 
of the network address and the endpoint vary depending on 
which protocol you are using. Table 1 summarizes the syntax 
for three of the most important protocols: TCP/IP, Named 
Pipes, and Local RPC. Here are a few important points to note: 

• Each "protocol sequence" has a specific name which can be 
found in the RPC documentation (for example, 
ncacn_i p_tcp for TCP/IP). 

• If the network address is not specified, the server program 
will be assumed to be running on the same machine as the 
client. (Of course, in the case of Local RPC, the server pro¬ 
gram is always on the same machine, so the network 
address is never used.) Also, note that the network address 
is needed only by the client RPC program; the server 
already "knows" its address, so it does not need to be speci¬ 
fied. 

• The computer's Host Name (used for TCP/IP) and its 
Computer Name (used for Named Pipes) are not necessarily 
the same. It is a good network administration practice to 
keep these names identical, but there is nothing in the sys¬ 
tem to enforce this. The Host Name is the name you use for 
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Table 1 RPC Binding Syntax 

Protocol, 

Protocol 

Sequence 

Identifier 

Network Address 
Syntax 

Endpoint Syntax 

TCP/IP, 

"ncacn_ip_tcp” 

Host Name or IP 
Address 

Examples: 

Computerl 

Computerl.xyz.com 

11.22.33.44 

A port number; use 
numbers greater than 
1024 (lower numbers 
are reserved for well- 
known services) 

Named Pipes, 
"ncacn_np" 

Computer Name 
(which is not 
necessarily the same 
as Host Name) 

Example: 

Serverl 

A pipe name: a text 
string beginning with 
the prefix "\pipe\" 

Example: 

\pipe\XyzPayroll 

Local RPC, 
"ncalrpc” 

Not applicable, since 
the client and server 
machines are always 
the same 

Any arbitrary text 
string agreed upon by 
the client and server 
programs 

Example: 

XyzPayroll 
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Listing 1 nsname.c — Formatting a name 
service name 


#1 nclude <windows.h> 
include "rpctips.h" 

void FormatNSName(const char * pCurrentDomain, 
const char * pSearchDomain, 
const char * pBareNSName, 
char * pFormattedNSName) 

{ 

/* 

pCurrentDomain is the domain we are currently running in 
pSearchDomain is the domain we want to search 
pBareNSName is the Name Service entry we want to search for 
pFormattedNSName will be returned as the formatted name to 
search for -- note that it must be big enough to hold 
the returned name (no error checking is done for this) 

*/ 

if (strcmpfpCurrentDomain, pSearchDomain) -- 0) 

1 

// Use same-domain name syntax 
strcpytpFormattedNSName, "/.:/"); 

) 

else 

( 

// Use other-domain name syntax 
strcpyfpFormattedNSName, "/.../"); 
strcattpFormattedNSName, pSearchDomain); 
strcat(pFormattedN$Name, "/"); 

1 

strcat(pFormattedNSName, pBareNSName); 

} 

/* End of File */ 
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TCP/IP connectivity such as FTP, WWW publishing, and so 
on. (You also use the Host Name when you "ping" a com¬ 
puter by name.) The Computer Name is used for Wmdows 
networking operations; for example, mapping a drive to 
\\computername\sharename. The Host Name and Computer 
Name are set separately in the Control Panel under both 
Windows NT and Windows 95. 

• For TCP/IP endpoints, use port numbers greater than 1024, 
since lower ports are reserved for well-known services. For 
Named Pipes, you can use any name beginning with \pi pe\, 
and for Local RPC, you can use any name at all. For both 
Named Pipes and Local RPC, you should use a prefix or suf¬ 
fix that represents your particular company and/or applica¬ 
tion to minimize the chance of duplicate endpoint names. 

With all of the above information, you can now run the 
"simple" hello application. Run the server program with a 
command line like this: 

hellos -p ncacn_ip_tcp -e 1111 

And run the client program like this: 

helloc -p ncacn_ip_tcp -n computerl -e 1111 

RPC Name Service 

As this example shows, you can have users specify RPC bind¬ 
ing information on your program's command line. 
Alternatively, you could hard-code the binding or allow it to 
be specified in the system registry. 

The Name Service 

Better yet, RPC lets you introduce a level of location trans¬ 
parency by using the RPC Name Service. An RPC server pro¬ 
gram can register its protocol and endpoint information with 
the Name Service and then a client program can query the ser¬ 
vice to look up the server program it wants to connect to. The 
server "exports" a name into the Name Service and the client 
queries for that name. The name can be any arbitrary string as 
long as the server and client use the same name. The name 
you choose should include a company and/or application 
name to reduce the potential for conflicts with other names. 
For example, the payroll application for the XYZ Company 
might use the name service entry: 

XyzPayroll 

The nhello sample program mentioned above shows how 
to export and import information to and from the Name 
Service database. The nhello sample has been implemented as 
an NT service. This is a useful example, but I found running 
the program as a service made understanding the name ser¬ 
vice portion more difficult. To avoid this, run the service in 
debug mode, which causes it to run as a console application 
instead of a service: 

nsserv -debug 

One of the more unusual aspects of the RPC Name Service 
is that the syntax for specifying the name you want to look up 
depends on the configuration of your network. For example, 
let's say you have two NT domains in your network called 
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EAST and WEST. If your client comput¬ 
er is in the EAST domain, and you want 
to look up the payroll server applica¬ 
tion in your own domain, you would 
use the syntax 

/.:/XyzPayrol1 

The syntax indicates "same 

domain" and is an artifact of the DCE 
compatibility mentioned above. If you 
want to look up the payroll server 
application in the WEST domain, you 
would use the syntax 

/.../WEST/XyzPayrol1 

The "syntax indicates "other 
domain." It is understandable that the 
Name Service database needs to be par¬ 
titioned by domain for bandwidth and 
performance reasons, but what is really 
unfortunate is that if both your client 
and server computers are in the EAST 
domain, the following syntax will not 
work: 

/.../EAST/XyzPayrol1 

It seems strange that that Name 
Service forces you to use the shorthand 
"same domain" notation — it would be 
handy to be able to use the “syntax 
even within your own domain. 
However, if you try this, you will get 
error code 1761, RPC_S_ENTRY_NOT_FOUND. 
What this means is that you need to 
have conditional code in your applica¬ 
tion to form the proper Name Service 
entry syntax. 

To solve this problem 
FormatNSNameO in nsname.c (Listing 1) 
takes both the current domain and the 
lookup domain as input to determine 
which Name Service syntax to use. It is 
not as simple to determine the current 
domain as you might expect, particular¬ 
ly since different methods are required 
for NT and Win95. domain.c (Listing 2) 
shows the best method I have come up 
with. If anyone knows a better way, I 
would appreciate hearing about it. 

Under NT, I call NetWkstaGet I nf o(). 
The first annoyance is that I have to 
explicitly do a Load Library!) and 
GetProcAddress( ) for this function 
because my code must be binary-com¬ 
patible across NT and Win95. If I use 
implicit loading for netapi32.dll , I will 
get an "entry point not found" error at 
load time on Win95. The second issue 
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under NT is that I have to manually translate the NetWksta 
information from Unicode to ANSI. 

Under Win95,1 could not find an API function to get the 
current domain, so I ended up querying the registry as shown 
in domai n. c (Listing 2). This makes me nervous, since I assume 
that this information may move or disappear in a future 
release of Win95. 

If you thought it was difficult to figure out the current 
domain, you might be wondering how to determine which 
domain a particular server application is running in; that is, 
which domain(s) should be searched for the application's 
Name Service information. The answer depends on the 


design of the application. For example, one of my applica¬ 
tions uses an Explorer-type window to allow the user to 
select the domain of interest. Then I simply pull the user's 
selection out of the tree control and form the Name Service 
name with code similar to nsname.C (Listing 1). Another 
application I worked on uses a registry key to allow the user 
to specify which domains beyond his or her own should be 
searched. For the ultimate in flexibility, you could write a 
"meta Name Service" that would run in each domain and 
contain dynamic mappings between applications and 
domains. But if you're going to go this far, you've almost got 
your own Name Service! 


Listing 2 domain.c — Finding the current domain 


#include <windows.h> 

// Get a pointer to the NetWkstaGetlnfo API, and call it 

#include <1m.h> 

if ( ((pfnNetWkstaGetlnfo - (PFN NETAPI) 

#1nclude "rpctips.h" 

GetProcAddressthNetApi, "NetWkstaGetlnfo")) — NULL) || 

/* 

((ret - (‘pfnNetWkstaGetlnfo) 

LookupDomain (and the platform-specific versions it calls) 

(NULL, 100, (UCHAR “) Splnfo)) I- 0) ) 

returns TRUE for success, FALSE if a system error occurs. 

( 

If successful, the current domain or workgroup will be 

FreeLibrary(hNetApi); 

returned in pDomain, else "Unknown" will be returned. 

return(FALSE); 

1 For this sample code, only minimal error-checking is done, 
and in particular the buffer size of pDomain is assumed 

} 

to be large enough to hold the returned data. 

// Translate Unicode to ANSI if necessary 

*/ 

BOOL LookupDomain(char ‘pDomain, DWORD buflen) 

// This assumes the domain or workgroup name is at 
// least 4 bytes long, which may not be safe in all cases 

( 

DWORD ret: 

ret - IsTextUnicode(pInfo->wki100_1angroup, 4, NULL); 

if (ret) // Convert Unicode to ANSI 

// Are we running on WinNT or Win95? 

WideCharToMultiByteCCP ACP, 

// Win95 does not support the necessary API to directly retrieve 

0, 

// the workgroup or domain, so we need to get it from the registry 

(const USHORT *) pInfo->wki100 langroup, 

-1, 

pDomain, 

OSVERSIONINFO osvi; 

memsettSosvi, 0, sizeof(OSVERSIONINFO)): 

buflen, 

osvi.dwOSVersionlnfoSize - sizeof(OSVERSIONINFO); 

NULL, 

if (!GetVersionEx(&osvi)) 

NULL); 

return(FALSE); 

ret - FALSE; 

else // non Unicode - just copy ANSI text 

strcpy(pDomain, pInfo->wki100_1angroup); 

FreeLibrary(hNetApi); 

if (osvi.dwPlatformld — VER PLATFORM WIN32 NT) 

return(TRUE); 

ret - LookupDomainViaNetworkfpDomain, buflen); 
else if (osvi.dwPlatformld — VER_PLATF0RM_WIN32_WIND0WS) 
ret - LookupDomainViaRegistry(pDomain, buflen); 

) 

BOOL LookupDomainViaRegistrytchar * pDomain, DWORD buflen) 

if (ret) 

{ 

return(TRUE); 

DWORD dwi/alueSize * buflen; 

else 

DWORD dwValueType; 

{ 

HKEY hKey; 

strcpy(pDomain, "Unknown"); 
return(FALSE): 

DWORD ret; 

} 

char * keyName - 

} 

"SystemUCurrentControlSetWServicesUVxOUVNETSUP"; 
char * valueName - "Workgroup"; 

BOOL LookupDomainViaNetworktchar * pDomain, DWORD buflen) 

if ((ret - RegOpenKeyExtHKEY LOCAL MACHINE, keyName, 0, 

{ 

KEYJUERY VALUE, &hKey)) !- ERROR SUCCESS) 

// Define a type for PFN_NETAPI, which will be used to declare 
// a function pointer for NetWkstaGetlnfo 

return(FALSE); 

typedef NET API STATUS 

ret - RegQueryValueEx(hKey, valueName, NULL, &dwVa1ueType, 

(*PFN_NETAPI)(LPTSTR serverName, DWORD level. LPBYTE *bufPtr); 

pDomain, SdwValueSize); 

HINSTANCE hNetApi - NULL; 

PFN NETAPI pfnNetWkstaGetlnfo - NULL; 

RegCloseKey(hKey); 

PWKSTA INFO 100 plnfo; 

if (ret — ERROR SUCCESS) 

0W0RD ret; 

return(TRUE); 
else 

// Load netapi32.dll, which contains NetWkstaGetlnfo 

return(FALSE); 

if ((hNetApi - LoadLibraryCnetapi32.dll")) — NULL) 

) 

return(FALSE); 

/* End of File */ 
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One last point on Name Service syntax: the Microsoft RPC 
documentation states that the "other domain" syntax 
works only for domains and not for workgroups. However, I 
have been using this syntax for workgroups as well as 
domains, and it seems to work correctly for both. 

rpctips.c (Listing 3) and rpctips.h (Listing 4) contain a 
simple console program that demonstrates the use of 
LookupDomain( ) and FormatNSNamet). 

This concludes the introductory topics; the next few tips 
cover some general RPC coding issues. 

Avoid RpcServerUseAllProtseqsO 

Although I encourage you to learn from and use the RPC 
sample code provided with your SDK or compiler, there is one 
coding practice I suggest you avoid. Some of the sample serv¬ 
er programs call the API function RpcServerUseAl 1 Protseqs (). 
This is convenient and quick to code, but there is a noticeable 
lag time at runtime because the server cycles through all the 
protocols. 

There are a couple of ways to avoid using this function. 
First, if your target deployment environment is well-known, 
you can simply hard-code your protocol(s) and document the 
required protocols as a prerequisite of your product. You 
could certainly make a case for requiring, say, TCP/IP to be 
installed and configured before your program will rim. 
Second, you could allow the protocol sequences to be speci¬ 
fied by the user or administrator through a registry key or 
some other means. 


Listing 3 rpctips.c — Program to demon¬ 
strate RPC tips 


//include <windows.h> 

//include <stdio.h> 

//include "rpctips.h” 

void main(void) 

{ 

static char bareNSNamef] - "Test"; 

char formattedNSName[256]; 

char myDomain[256]; 

char otherDomain[256]; 

if (LookupDomainimyOomain, sizeof(myDomain))) 
printfC'Current domain is; fe.\n", myDomain); 
else 

printfC'Current domain is unknown.\n"); 

strcpyfotherDomain, myDomain); 
strcattotherDomain, "_XYZ"); 

FormatNSNametmyDomain, myDomain, 
bareNSName, formattedNSName); 

printfC'To lookup name Is in domain %s, the syntax is; %s.\n”, 
bareNSName, myDomain. formattedNSName); 

FormatNSNameimyDomain, otherDomain, 
bareNSName, formattedNSName); 

printfC’To lookup name Xs in domain %s, the syntax is: %s.\n”, 
bareNSName, otherDomain, formattedNSName); 

) 

/* End of File */ 


With MemCheck watching over your code, 
you'll notice is that you'll spend significantly 
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In general, use the fewest number of protocols that will 
allow you to get the job done while providing the connectivity 
you need. This will conserve memory and network resources. 

Wrap Exception Handling 

The RPC runtime uses a macro-based exception-handling 
scheme, which may not be compatible with the error handling 
you are using. In particular, it is not directly compatible with 
C++ exception handling. As shown below, you can protect 
each RPC call with a wrapper that returns an error code to 
your calling routine: 

RpcTryExcept 

1 

ret = RpcNsBindinglmportBegi n (...); 

} 

RpcExcept(l) 

( 

ret = RpcExceptionCodef); 
return(ret); 

1 

RpcEndExcept 
if (ret != 0) 
return!ret); 

As you can see, your code needs to catch exceptions thrown 
by the RPC runtime, as well as error codes returned from the 
RPC call. Then, in your calling routine, you can throw your 
own exception or handle the error however you wish. 
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Avoid Endpoint Conflicts 

I've already advised you to pick unique endpoint prefixes 
for protocols that allow it (such as Named Pipes and Local 
RPC) to avoid potential conflicts. This is more difficult with a 
protocol like TCP/IP, where — unless your application is very 
well-known — you are essentially picking a port number at 
random and hoping that nobody else wants to use it. 

The first thing you need to do is code defensively — expect 
that conflicts will occur and make your code resilient. For 
example, you can pick a starting port number, and if it turns 
out to be in use, you can go into a loop trying other ports until 
you find a free one. 

Equally important, your code needs to clean up after itself 
when shutting down. NT will generally clean up all your 
resources for you (although good coding practice is to do it 
yourself). But Win95 is much less forgiving — if you do not 
clean up, you will have resource leaks and you will be prevent¬ 
ed from (for example) re-registering an endpoint until you 
reboot. Many of the RPC server API calls come in pairs: one 
API to allocate a resource and another to free it. Make sure that 
you are calling the cleanup APIs whenever they are available. 

The last few tips cover RPC configuration issues. 

Windows 95 Protocols 

There is some misleading information in the Microsoft RPC 
documentation regarding which protocols are supported on 
Windows 95. 

First, the documentation states that Win95 does not sup¬ 
port Named Pipes (protocol sequence ncacn_np). It is true that 
Win95 does not support server-side Named Pipes — this is an 
intentional restriction in the operating system and is not spe¬ 
cific to RPC. However, Win95 does support client-side Named 
Pipes, so you can have a Win95 client connect to an NT server 
via Named Pipes. 

Second, the documentation states that Local RPC (protocol 
sequence ncalrpc) does not run on Win95. This is incorrect; 
Local RPC works perfectly well on Win95. 


Listing 4 rpctips.h — Header file for 
rpctips.c 


void FormatNSNametconst char * pCurrentDomain, 

const char * pSearchDomain, 

const char * pBareNSName, 

char * pFormattedNSName): 

BOOL LookupDomain(char ‘pDomain, DWORD buflen); 

BOOL LookupDomainViaNetwork(char * pDomain, DWORD buflen); 

BOOL LookupDomainViaRegistry(char * pDomain, DWORD buflen); 

/* End of File */ 


Listing 5 namesvc.reg — Accessing NT 
Name Service from Win95 


REGEDIT4 

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Rpc\NameService] 
"DefaultSyntax"-"3" 

"Endpoint"-"\\pipe\\locator" 

"NetworkAddress"-"\\\\niyNTmachine" 

"Protocol "-"ncacnjp" 
"ServerNetworkAddre$s"-"\\\\myNTmachine” 
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NT Services for RPC 

Windows NT has two NT services that provide RPC fea¬ 
tures: RPC Service (RPCSS) and RPC Locator Service (RPCLO- 
CATOR). You can view and manage these services through 
the Services applet in the NT Control Panel (for example, set¬ 
ting their startup type to Manual or Automatic). 

In general, if you run a program that requires one of these 
services, the necessary service will be automatically started. 
However, if you develop an NT service that uses RPC, when 
you register your service, you must indicate its dependency 
on the above services so that NT's Service Control Manager 
will start the services in the correct order. See the call to 
CreateService() in the nhello sample 
discussed previously for an example of 
how to do this. 

Since Windows 95 does not support 
services, the RPC service runs as a hid¬ 
den .exe (rpcss.exe). This program gets 
launched by Win95 whenever neces¬ 
sary. If you run a process viewer pro¬ 
gram on Win95 when you are running 
an RPC program, you will see 
rpcss.exe running. 

Name Service on 
Windows 95 

The Microsoft Name Service imple¬ 
ments a distributed database that is 
replicated to all NT machines on the 
network. Windows 95 does not natively 
run the name service software (the 
RPCLOCATOR service), and by 
default, a Win95 machine does not have 
access to the Name Service data. 

However, you can use the Name 
Service on Win95 by configuring your 
registry to "point" to an NT machine 
which will provide a surrogate name 
service database for the Win95 machine. 

I have not noticed any restrictions on 
which NT machine you choose. 

Theoretically, it appears that you could 
choose any machine on the network, 
but as a practical matter, it makes sense 
to choose a machine that is in your own 
domain or workgroup and in close 
physical proximity. 

The relevant registry key is: 

HKEY_LOCAL_MACHINE 
\S0FTWARE 
\Microsoft 
\Rpc 

\NameService 

You can look at the above key on any 
NT machine to get an idea of the values 
to set, then edit your Win95 registry 
accordingly. Or, create a text file with 
the extension . reg, such as namesvc. reg 


(Listing 5). Edit the NetworkAddress and ServerNetworkAddress 
values to specify the name of the NT computer whose Name 
Service database you wish to access. Leave all the other values 
as shown. Then double-click on the .reg file in the Win95 
Explorer and your registry will be updated. 

Conclusion 

RPC can be a very useful tool in your programming 
toolkit, particularly since the RPC runtime is available on 
every Win32 desktop. Using the tips in this article should 
save you some time and frustration as you implement your 
own RPC programs. □ 
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Internet Downloading via 
wininet.dll 

Sven B. Schreiber 


Downloading a file from the Internet always requires some sort of TCP/IP client, 
usually a Web browser or FTP utility. Under Windows, these clients typically use the 
Windows Sockets (WinSock) programming interface, which is very flexible, but also 
requires intimate knowledge of the TCP/IP protocol suite and related tools. If 
you've got Microsoft's new ActiveX SDK on hand, tasks such as a simple file down¬ 
load need not be that complex. 

What is wininet.dll? 

Conceptually, downloading a file from the Internet should be as simple as an 
extended DOS copy command. If you know the complete Uniform Resource Locator 
(URL) of a remote file, you already know how to locate the file on the net, wherever 
in the world it may be. The URL indicates the file's name, on which host to search for 
it, in which directory tree it resides, which protocol is needed to access it, and, 
optionally, which port to use to contact the host. Shouldn't this suffice to get the file 
across the face of the earth? Unfortunately, the transfer protocols involved in down¬ 
loading files require a non-trivial amount of programming. 

Starting with the Win32 SDK of Windows NT 4.0 Beta 1, Microsoft supplies a hot 
new piece of software, named wininet.dll, that is currently a redistributable DLL, 
but will become an ordinary system component of Windows NT 4.0. This DLL and 
the C /C++ support files needed to access it are now part of the Microsoft ActiveX 
SDK, a beta of which was distributed to MSDN members some months ago. The 
SDK is also available online at http://www.microsoft.com/insdownload/activex.htm. 

With wi ninet.dl 1, the lives of Internet client developers everywhere are about to 
become much happier. The API of this DLL is documented in NT's Win32 SDK, 
somewhere in the book "Internet". The exact location seems to vary, depending on 
which Beta release you have installed. But it's still beta material, so I hope that 
Microsoft was able to make some improvements before NT 4.0 was sent to the man¬ 
ufacturer. Also, in the August 1996 issue of Microsoft Systems Journal, Windows inter¬ 
nals expert Matt Pietrek takes a short look at this new interface. 

While wininet.dll provides some really nice high-level APIs for FTP, HTTP, and 
GOPHER clients, most programmers will probably find the "General Purpose" set 
of functions — those whose names begin with the prefix "Internet" — most useful. 
In fact, if you want to download a file from the Internet, all you really need are four 
functions: I nternetOpen (), InternetOpenUrl (), InternetReadFile(), and 

InternetCloseHandlet ). To upload a file, you would need I nternetWri teFi 1 e( ) instead 
of InternetReadFi 1 e( ). This article demonstrates wi ni net .dll with a complete console 
application that makes Internet file downloading as simple as a DOS copy command. 


Sven B. Schreiber has been a systems programmer for over 11 years, always working at the 
lower end of the PC operating systems to find their secrets. He is addicted to the " Freezvare" 
principle, and desperately tries to save assembly language programming from becoming a 
dying art. You may contact Sven at sbs@psbs.franken.de or via CompuServe at 100557,177. 
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Calling into wininet.dll 

To access wininet.dll, first open an Internet session using 
I nternetOpen(): 

HINTERNET hSession; 
hSession = InternetOpen ( 

sCaller, // string to uniquely identify 
LOCAL_INTERNET_ACCESS, 

NULL, 

INTERN ETJNVALID_PORT_NUMBER, 

INTERNET_FLAG_DONT_CACHE); 


Key Facts 

❖ wi ni net .dll provides a high-level Internet API; it ships 
as part of NT 4.0. 

❖ Get the software from the ActiveX SDK, either on the 
MSDN CD-ROM or from 

http://www.microsoft.com/msdownload/activex.htm. 

❖ Use InternetOpenO to open an Internet session (obtain¬ 
ing a handle used in subsequent calls) and 
InternetCloseO to close it. 

❖ Perform Internet file I/O with InternetOpenUrl (), 
InternetReadFilef), and InternetWriteFi 1 e(). 

❖ InternetCl oseHandl e( ) closes both session handles and 
URL handles. O 
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HINTERNET is the basic handle type of wininet.dll. 
InternetOpenO returns NULL if it fails. You must pass 
InternetOpen( ) a string (the sCal 1 er parameter) that uniquely 
identifies the session. If your application never has more than 
one session open at a time, it could simply use a string con¬ 
taining the application name, for example. 

After successfully opening a session, you're set to open a 
remote file. Call InternetOpenUrl () with a properly formatted 
URL: 

HINTERNET hSource; 
hSource - InternetOpenUrl( 

hSession, // handle from InternetOpenO 
sSource, // string containing URL 
NULL, 

OxFFFFFFFF, 

INTERNET_FLAG_DONT_CACHE | 

INTERNET_FLAG_RAW_DATA, 

0): 

Again, the returned handle is NULL if the remote file could not 
be opened. What's really interesting about InternetOpenUrl () 
is that you do not need to specify which protocol to use for 
download. InternetOpenUrl ( ) establishes the correct type of 
connection based on the information available from the URL. 
All login/logout and directory searching is done automatical¬ 
ly and transparently. However, InternetOpenUrl () seems to 
have some problems detecting all possible error conditions. 
For example, if you are using Windows NT RAS to log into the 
net, InternetOpenUrl () hangs if no PPP connection has previ¬ 
ously been established. 

Unfortunately, HINTERNET handles are not of the same kind 
as file handles, so you must not feed them into any of the 
Win32 file I/O functions. Instead, there are special read and 
write functions to download or upload a file, respectively. On 
the local side of the remote connection, you simply use 
CreateFi 1 e( ), Wri teFi 1 e( ), and Cl oseHandl e( ) to save a down¬ 
loaded file. 

The download ritual is straightforward. Similar to reading 
a file from disk using ReadFi 1 e (), you call InternetReadFi le( ) 
to obtain chunks of data: 

(/define FILE_BUFFER_SIZE 4096 

BOOL fOk; 

BYTE bFileBuffer [FILE_BUFFER_SIZE]; 

DWORD dReadFi1eCount; 

fOk - InternetReadFile ( 

hSource, // from InternetOpenUrl() 
bFileBuffer, 

FILE_BUFFER_SIZE, 

&dReadFi1eCount); 

This function returns TRUE if the data has been transferred suc¬ 
cessfully, and FALSE if not. The value chosen for 
FILE_B UF FER_SI Z E is not critical. InternetReadFi 1 e( ) provides 
its own buffer and usually blocks until the requested amount 
of data has been collected or the end of file is met. However, 
you should always check dReadFi 1 eCount, which holds the 
number of bytes actually read, because it's perfectly legal for 
InternetReadFi 1 e( ) to return prematurely. If an error occurs 
(fOK == FALSE), you should retry the read operation because 
the error might be due to temporary network instability. 
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Listing 1 easydl.c — Console app to download Internet files 

//include <windows.h> 

dReadFi1eCount - 0; 

//include <stdio.h> 

fOk - InternetReadFile (hSource, 

//include <wininet.h> 

bFileBuffer, 

//define FILE BUFFER SIZE 4096 

FILE_BUFFER_SIZE, 

SdReadFileCount); 

//define RETRY READ 10 

) 


while (!(dReadFi 1 eCount || fOk || uRetry++— RETRY_READ)); 

char slnputUrl [INTERNET MAX URL LENGTH] - 

char sOutputPath [MAX PATH] - 

if (dReadFiieCount) 

HANDLE hStdOut; 

( 

DWORD dReadFi1eCount, dWriteFileCount, dWriteFi1eTotal; 

dWriteFileCount - 0; 

VOID Banner () 

fOk - WriteFile (hDestination, 
bFileBuffer, 
dReadFiieCount, 

{ 

&dWriteFi1eCount, 

printf ("\nWDJ EasyDL VI.00 / 07-21-96 Sven B. Schreiber\n\n"): 

NULL); 

} 

if (fOk - fOk M (dReadFi1eCount — dWriteFileCount)) 

VOID Usage 0 

dWriteFi1eTotal +- dWriteFileCount; 

else 

t 

printf ("Usage: EasyDL <Source URL> [<Destination>]\n">; 

dReadFi1eCount = 0; 

printf ("\n"); 

printf ("\n!ll Error writing data !!!"); 

printf ("Valid URL schemes are ftp, http, and gopher.\n"): 

} 

printf ("If no destination is specified, STDOUT is assumed.\n"); 

1 

} 

else 

DWORD BytesPerSecond (SYSTEMTIME *pStartTime, 

if (!fOk) 

DWORD dBytes) 

printf ("\n!!I Error reading data !!!"); 

SYSTEMTIME CurrentTime; 

1 

DWORD dStartSecond, dSeconds; 

while (dReadFileCount); 

dStartSecond - (((DWORD) pStartTime-XwSecond) ) + 

if (hDestination — hStdOut) 

(((DWORD) pStartTime->wMinute) * 60 ) + 

printf ("\n. [ END ] ."); 

(((DWORD) pStartTime->wHour ) * 60 * 60); 


GetSystemTime (SCurrentTime); 

printf ("\n\n"); 

1 

dSeconds - (((DWORD) CurrentTime.wSecond) ) + 

// . 

(((DWORD) CurrentTime.wMinute) * 60 ) + 


(((DWORD) CurrentTime.wHour ) * 60 * 60) - 

VOID GetlnternetFile (HINTERNET hSession, 

dStartSecond; 

char sSource [], 

if (dSeconds & 0x80000000) (dSeconds +- 24 * 60 * 60;) 

char sDestinati on []) 

{ 

return (dSeconds ? (dBytes / dSeconds) : 0); 

HINTERNET hSource; 

HANDLE hDestination; 

//--—-—-______ 

// INTERNET INTERFACE 

printf ("Opening \"Xs\"\n", sSource); 
hSource - InternetOpenUrl (hSession, 
sSource, 

// ---——--- 

VOID DownloadFile (HINTERNET hSource, 

NULL, 

OxFFFFFFFF, 

INTERNET FLAG DONT CACHE | 

HANDLE hDestination) 

INTERNET FLAG RAW DATA, 

( 

0); 

UINT uRetry; 

if (hSource !- NULL) 

BOOL fOk; 

{ 

BYTE bFileBuffer [FILE BUFFER SIZE]; 

if (isOutputPath [0]) 

SYSTEMTIME StartTime; 

( 

if (hDestination — hStdOut) 

printf ("Output directed to STDOUTYn"); 
hDestination - hStdOut; 

printf ("\n-- [ BEGIN ] .\n"): 

1 

dWriteFiTeTotal - 0; 

else 

( 

GetSystemTime (SStartTime); 

printf ("Creating \"%s\"\n", sDestination); 

do 

hDestination - CreateFile (sDestination, 

GENERIC WRITE, 

t 

FILE SHARE READ, 

if (hDestination !- hStdOut) 

NULL, 

( 

CREATE NEW. 

printf ("\r%lu bytes transferred ... ", 

FILE FLAG WRITE THROUGH | 

dWriteFiTeTotal); 

FILE FLAG SEQUENTIAL SCAN, 

printf (”(%lu bytes/sec) 

NULL); 

BytesPerSecond (JStartTime, dWriteFi1eTotal)); 

} 

) 

if (hDestination !- INVALID HANDLE VALUE) 

uRetry - 0; 

t 

printf ("\nStarting Downloadin''); 

do 

{ 

DownloadFile (hSource, hDestination); 
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After the file has been transferred, indicated by a return 
code of TRUE and dRead Fi 1 eCount being zero, all that remains to 
be done is to close all open handles. But beware: never 
attempt to use the Win32 standard API function CloseHandleO 
on an HINTERNET. InternetCloseHandle( ) does the job for all 
types of Internet handles: 

InternetCloseHandle (hSource); 

InternetCloseHandle (hSession); 

That's it, essentially! System interaction is minimal, and 
you don't need a single line of TCP/IP-specific code or any 
FTP, HTTP, or GOPHER gimmicks. Rather than be concerned 
about proper protocol implementation, you can focus on use¬ 
ful program options or on a brilliant user interface. 

Prerequisites 

Before you can begin interfacing to wi ni net .dll, you need to 
prepare your system with three files: wi ni net. h, wi ni net .lib, 
and wi ni net .dll, which are in the ActiveX SDK. Place 
wi ni net. h and wi ni net. 1 i b into one of your standard i ncl ude 
and lib directories (e.g., \mstools\include and \mstools\l ib, 
respectively). Place wi ni net .dll into %systemroot%\system32 
(WinNT) or %systemroot%\system (Win95). If you've installed 
the ActiveX SDK or one of the NT 4.0 Win32 SDKs, some of 
these files may be in place already, so check your directories 
before manually copying them. 

In your source file, insert 

#include <wininet.h> 

somewhere after you include wi ndows. h. This tells the compil¬ 
er all it needs to know about wi ni net .dll. But you must also 
inform the linker about the symbols imported from this new 
DLL. If you are using Microsoft VC4, edit your project settings 
by selecting "Settings" from the "Build" menu, click on the 
"Link" tab, and add wi ni net. 1 i b to the "Object/library mod¬ 
ules." Finally, wi ni net .dll must be somewhere in the system's 
module search path so that your executable can access it. For 


Listing 1 easydl.c — continued 


if (hDestination !- hStdOut) 

{ 

printf ("Closing \"*s\"\n", sDestination); 

CloseHandle (hDestination); 

1 

} 

else 

printf ("\n!M Output file not created !!1\n\n"); 
printf ("Closing \"fo\"\n", sSource); 
InternetCloseHandle (hSource); 

} 

else 

printf ("\n!M Internet URL not opened !!!\n\n"); 

} 


VOID InternetSession (char sCaller []) 

{ 

HINTERNET hSession; 

printf ("Opening Internet Session \"Xs\"\n", sCaller); 
hSession - InternetOpen (sCaller, 

LOCALJNTERNET.ACCESS, 


Viewing 


"View" Enable 
Your Application 

Introducing the most extensive viewing libraries- 
Viewing & Conversion Enabling Technology 
(VCET™), an OEM product from C.S.I.. 

Add viewing capabilities for any format within 
your windows application in a matter of hours! 

VCET is the same technology used in AutoVue® 
and other leading viewing and document 
management software. 


Your Application 





VCET "View" 
Window 


"Intergraph uses C.S.I. technology in our DM/View 
and DM/Redline products. The products are well 
received with our customer base." 

Terry Lynch, Executive Director of TIMD, Intergraph Corp. 

"'We were easily able to integrate VCET into our 
software application. It was the simplest part of the 
development process." 

Mike Hunting, Project Manager, Kruse Inc. 


Instantly support over 150 file formats! 

Office Documents 

MS-Word, WordPerfect, AMIPRO, MS-Excel, Lotus 123, Quattro Pro, 
dBase, Paradox... 

Engineering Documents 

AutoCAD, MicroStation, CADKEY, HPGL, IGES, CGM, CALS GP4, 
TIFF, Hybrid... 

Desktop Formats 

PS, EPS, JPEG, GIF.... 



(800)361-1904 

C Q / Tel: (514) 735-3219 

Fax:(514) 735-6440 

Cimmetry Systems Inc. bbs: (5i4) 735-3905 


: All other Brand and product names ai 
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Tired of Wrestling with OCX/DLLs?? 



WWW.STINGSOFT.COM 


Objective Grid 1.1 


Objective Toolkit 1.1 


Objective Plug-in 1.0 


A full featured MFC grid 
control that you can bind to 
any data source with one 
virtual function override! 
ODBC and DAO are fully 
supported. Also supports 
UNICODE, find/replace, 
print preview, undo/redo 
and features a flexible 
cell control architecture. 


A package of over 40 MFC extensions 
including sizable docking views (like 
Developer Studio), tabbed windows, 
masked edit, image classes, MDI 
alternatives (workbook and floating 
documents), calendar control, shortcut 
editor, encrypting/compressing 
CFiles, panning/zooming CViews, 
Workspace manager, thumbnailing 


Convert any MFC application 
into a Netscape plug-in. Let our 
plug-in wizard and helper 
classes do the work for you! 



'We add class to MFC!' 


_ 1-800-924-4223 

All products feature FULL SOURCE CODE, 100% MFC compatibility, and a 30-day \ Voice: (919) 933-0863 
money back guarantee! Bundle pricing is available. Check our web for free demos. Fax: (919)933-0892 
. . . --—i— J Email: sales@stingsoft.com 
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DLLs used system-wide, the Windows system directory is the 
right choice. Please note that although wininet.dll is a 
Windows NT 4.0 component, it also works well with 
Windows NT 3.51. 

Need some sample code? 

easydl .C (Listing 1) is a simple Win32 console application 
that downloads a file from the Internet with a single com¬ 
mand. The command syntax of easydl .exe is: 

EasyDL <Source URL> [<Destination>] 

If no <DeSt i nati on> is specified, the downloaded file is output 
to the console window. This involves no more work than a 
DOS copy command, except that URLs can be somewhat 
lengthy in real life. 

Summary 

Downloading files from the Internet need not be a complex 
operation. With Microsoft's new ActiveX SDK, you get an 
Internet interface DLL (wininet.dll) that allows you to access 
files on the net with minimal effort. With a tiny set of only four 
functions, it's possible to write a general-purpose file down- 
loader that needs no knowledge of the transfer protocols. All 
host interaction is done transparently by wininet.dll and is 
completely hidden from the programmer and the end user. 
This will certainly simplify Internet application developers' 
lives — finally. □ 


Listing 1 easydl. c — continued 


NULL, 

INTERNET_INVALID_PORT_NUMBER, 
INTERNET_FLAG_DONT_CACHE); 

if (hSession !- NULL) 

( 

GetlnternetFile (hSession, slnputUrl, sOutputPath); 

printf ("Closing Internet Session \"fe\"\n", sCaller); 
InternetCloseHandle (hSession); 

1 

else 

printf ("\n!l! Internet session not opened !!!\n"); 

1 

// --- _________— - 

// MAIN PROGRAM 

// -——_____— . . ——„ 

void main (int argc, char *argv [], char *envp []) 
f 

hStdOut - GetStdHandle (STD_OUTPUT_HANDLE); 

Banner 0; 

if (argc > 1) 

{Istrcpyn (slnputUrl, argv [1], INTERNET_MAX_URL_LENGTH);} 
if (argc > 2) 

{Istrcpyn (sOutputPath, argv [2], MAX_PATH);} 

if (slnputUrl [0]) 

InternetSession ("EasyDL/1.00”); 

else 

Usage (); 

} 

/* End of File */ 





Multi-Edit is a trademark of American Cybernetics, Inc. Other products are trademarks of their respective publishers Delphi is a trademark of Borland. Developer tested 
only. American Cybernetics stands behind all of its products with a 30 day Money Back Guarantee. No animals were eaten by other animals duhng the making of this ad. 


For more than eight years, Multi-Edit has increased programming productivity world-wide. 
With extensive support for C/C++, Delphi, Java, Fortran, COBOL, HTML, PERL (just to name a few), and 
features like code templates, hex-editing, file compare, VCS integration, multi-file 
search and replace, and more, Multi-Edit will do the same for you! 


"Unbelievable, the best 

editor I've ever used..." 

- Ross Mason; Shelby Systems, Inc. 


Lost in a jungle of languages? Crushed in the coils of immense binary files? 
Unable to escape the voracious jaws of impending deadlines? Are your 
development projects eating you alive ? 

OK, it’s probably not quite that bad. Still, you are confronted daily with the challenge 
of managing large numbers of source files, using multiple languages & compilers, 
integrating with different vendors 1 tools, and coordinating with other developers' 
work. The last thing you need is to be burdened with inflexible, under-powered 
editing tools. You need an editor designed to adapt to your own individual work 
style, that supports the languages you work with, one that will SAVE YOU TIME! 
Multi-Edit is your answer. 


Get an in-depth look at what Multi-Edit can do for you. 
Visit our web site and check out our fully functional demo! 

www. amcyber. com 

1 - 800 - 899-0100 


Suggested 
Retail Price 
$199 


1830 West University Dr. Ste.112 
Tempe, AZ, 85281 
Voice: (602) 968-1945 
Fax: (602) 966-1654 


November 1996 


□ Request Reader Service #120 o 


Windows Developer’s Journal — Page 25 




















And mark your calendars for: 

Web Design & Development '97 
February 22-26,1997 

Moscone Convention Center, San Francisco, CA 
In November 1996, go to www.web97.com 


lost web sites 
are about as 
interactive as a 
dead cat. 

But we're changing all that. Our 75 conference classes will teach you to 
slim down graphics, speed up your site, link up to your corporate data¬ 
base, increase security, manage cybercash and a hell of a lot more. 
We don't print a catalog, so to learn more and register, do what any self- 
respecting web developer would do—visit our web site. 



Feeling nostalgic? Contact us by phone at 617.821.9215 or by e-mail at web96@mfi.com 




Builders 


Web Design 8c Development *96 East 
October 28-November 1,1996, Washington, D.C. 

In conjunction with Software Development '96 East 

Co-sponsored 

MACROMEDIA ASYMETRIX Microsoft 
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SHOWCASE 


Internet VBXs/OCXs 
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Let PowerTCP™ bring proven TCP, Telnet/VT220, 
FTP, POP3, SMTP, UDP, TFTP and SNMP 
components (OCX/VBX/VCL/DLL/Class Libraries) 
to your next project! With numerous samples 
and expert technical support, results 
happen fast! NO ROYALTIES. 

Get a trial toolkit from our web site today! 

http://www.dart.com 


SftTree/OCX Tree Control 




| Description 
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1 XetoxDocuTech 135 (A);1$t Floor, Printer Ro... ; V Ready 


as HP LaserJet III PS 
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E TREEXBC 
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3 S HP LaserJet 4 
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; 2nd Floor. Room 228 
Sample Program 


0 Ready 
V.' Printing 
V. Ready 



Additional document... j gj Re ady 
2nd Floor, Room 2(K |j^m| 

I Most urgent output [□ Not ready 


See our Web pages 
for a complete list of 
features and to 
download a demo! 


From simple listbox with bitmaps to multi-line, multi-column, hierarchical data display, 
SftTree/OCX delivers' Includes 16-bit and 32-bit OCX controls supporting all popular 
environments including VB. Delphi, Access, etc. Also available as a DLL-based version 
(see our other ads in this magazine). 


email: info@dart.com 
Ph: (315)431-1024 
Fax: (315)431-1025 


*DART 

COMMUNICATIONS 


Not The Industry Standard 

11 Michigan Ave 
Wharton, NJ 07885 


Call today ( 201 ) 366-9618 

for your FAX (201) 366-3984 

free demo' http://www.softetvdm.com 
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DynamiCube ActiveX 32-bit Multidimensional OLAP Grid 


Binds to Data Control, Remote Data 
Control, DAO, RDO, and ODBC 
High speed, Drill Down, Rollup analysis 

Fast data filtering, drag & drop data 
pivoting 

Easy to use design-time layout editor 

Create calculated fields with built-in 
expression evaluator 

Fully programmable standard and 
extended properties, methods and 
events 

Time-series support (Year, Quarter, 
Month...) 
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"Industrial-strength...superb" —pc Magazine 


Instantly Search 100s 

f llfl Sk S 

dSearc/iijopowe^fe medy.'—PCConyuflrtg # 

-Ulii: of Text or Source Code 

dtSearch Relevancy-ranked natural language 
i searching, fuzzy, phonic, Boolean, 
wildcard, proximity, field and numeric 
range text search options. Searches 
with or without a search index. (Can 
index over 13 MB/min. Indexed search time 
usually under a second.) Unlimited capacity; automati¬ 
cally works with word processor, database, ZIP, HTML 
files & more. (Display of HTML files has “live” hypertext links; 
launch option pulls up HTML page in your Web browser.) 

Built-in graphics viewer. Hypertext-linked “hit” displays. 
Batch script language; DDE-API. Cut/paste/copy/print/launch. 

dtSearch 4.1 for Win 95/NT (32-bit) $199 LAN 5 $800 
d6-bit version available). Norton Navigator™ users: please 
see the back of that manual for information on dtSearch add-on! 

Instantly Turn Papers into dtSearchable, HTML or 

Other Files. dtSearch 4.1 8i Xerox TextBridge Pro 96 
upgrade" $299 ' Offer applies to users of any OCR software. 


|Add dtSearch's proven Text Retrieval 
Engine to your product! 


DLL interface for easy use from C+ + and C. 

OLE Automation interface for easy use from VB. 
Commercial software incorporating the dtSearch Engine is in 
use on hundreds of thousands of computers around me world. 

Versions available: Win32, Win32s, UNIX $ 1,000 for use on 

an Internet server, for 5 concurrent users on a LAN, or for up 
to 5 PCs CD publishers, ask about Electronic Publisher’s Toolkit 

1-800-IT-FINDS www.dtsearch.com 
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Orbits correspond to J=constant contours 



J=l-(r 2 -l) 2 +ecos(0) 

Stunning technical graphics are easy 
from Visual Basic, Fortran, or C/C++ 

With the Graphic library only a few function calls 
are needed to add powerful graphics like this to 
your programs. Graphic handles the GUI for you 
so that you can concentrate on your programs. 
Visit our Web site at: http://www.sciend.com 

Scientific Endeavors Corporation 

508 N. Kentucky St., Kingston, TN 37763 
Toll free: (888)376-4148; (423) 376-4146; FAX:(423) 376-1571 

»- v 
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Visual Basic*: Debug, Optimize & Analyze It All 

with Marquis VB/FailSafe r 


Marquis VB/FailSafe Takes You 
Above and Beyond Visual 
Basic’s Debugger! 

VB/FailSafe Highlights Bugs! Watch OLE 
servers & program flow. Spot event 
driven bugs & uncontrolled recursion. 
Monitor memory & resource usage. Catch 
parameter errors, symbol table exhaustion, 
control problems, OCX/VBX/DLL version 
conflicts, WinAPI errors & lots more! 

VB/FailSafe Crash-Proofs your Programs 

by automatically intercepting and coding 
errors by class, project, module, procedure 
and line number. Writes log files for later 
debugging and QA. Shows calls leading to 
the error, over 75 data points to help you 
spot platform problems fast! 

VB/FailSafe Analyzes & Profiles 

procedures with microsecond resolution. 
Profile resources, memory, hits, time, 
utilization, Graphically displays information. 
Highlights performance bottlenecks! Spots 
memory hogs! Much more! 

Money Back Guarantee! • Free Demo 
P.O. Box 387, Pomfret Center, CT 06259 
(860) 963-7065 fax (860) 928-7727 


“Marquis has assembled some dynamite tools 
and utilities. They go above and beyond 
Visual Basic’s debugging capabilities... 

for smooth operation. ” 
—VB Tech Journal, Feb. ’96 




VB/FailSafe vs. Visual Basic 


Get VB/FailSafe, Call Now (800) 818-1611 

VB/FailSafe for Visual Basic...still only $179.95 
FREE DEMO! http://www.marquistools.com 
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Visual Basic Tool Showcase 
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Academus AS 

Olaf Helsetsvei 6 
Boks 70, Bogerud 
0621 OSLO, NORWAY 


Phn: +47 22627390 Fax: +47 22627492 
E-mail: academus @ academus.no 
Home page http://www.riksnett.no/academus 


AcademusView VBX/OCX 
views AutoCAD DWG files fast 
and easy. Now includes 
support for R13 with optional 
preview.Features includes 
linetypes, solids, fonts, attribs, 
x-refs, and much more. Only 
$99/$199 (no royalties). 

AcademusView VBX/OCX PRO 
version offers functionality 
such as full zoom, pan, print, 
clip. Just $990/$1990 (no 
royalties). 
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6 Great Controls 


TE Editor (Advanced RTF control). 
HTML Viewer Control Add-on for TE. 
ReportEase Plus (report writer engine). 
SpellTime DLL and dictionary. 

Rich Text Grid control. 

ChartPro (bar,pie,line,point) control 


^All products ^ 

include complete 
source code, are 
royalty free and 
available for 16 or 
32 bits. 


Sub Systems, Inc. 1-800-447-6819 

11 Tiger Row, Georgetown, MA 01833, 508-352-9020, Fax: 508-352-9019 

Demos available: http://www.subsystems.com 


The Conversion Assistant 

Version 3.5 Now Supports VB4.0! 


Visual 

Basic 


Delphi 


,V Form translation including object placement 
ft and sizing 

■wr Color and font translation 

☆ Line by line translation of Basic to Object 
Pascal to produce maintenance-easy code 

'( Customized mapping of third party controls 
Mapping of common built-in VBX controls 

☆ Event code translation „ 

* Handles VB control arrays ^ rom 

* DLL support 

"The Conversion Assistant will provide an immediate 
productivity gain for those developers wishing to move 
to Delphi. p au j H Q ross Borland International 
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7 Mountain Rd Burlington MA 01803 
Voice (617) 273-0308 Fax (617) 270-4437 

Visual Basic is a trademark of Microsoft Corporation. Delphi is a trademark of 
Borland International. VISA and Mastercard Accepted 
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1 in 5 current Wise users switched 
from InstallShiekT, the othg^ 
*T\ 80% saved themselves®!* 

' ’ some time and $600. / v - 


The Wise Installation System 5.0 


Save yourself time and money - try the Wise Installation System. The 
Wise Installation System is a Windows based installation editor that 
creates professional setup programs in hours, not days. It creates a 
single installation that runs in Windows 3. lx, Windows NT" or 
Windows 95®. It comes complete with bothWinl6 and Win32 versions, 
creates shortcuts/shell links for use with Windows 95, handles nested 
components and has a full uninstaller. It is completely customizable to fit 
your needs. Also available is the SmartPATCH® Add-in.This 
application, especially made for Wise, allows you to ship your upgrade 
using fewer floppies. It also allows you to post streamlined and secure 
upgrades on the Internet, so that only registered users can use it. Stop 
wasting time and money - order today! 


De»i|n»4 for 



Microtofr 

Window* 95 



To order call 1 - 800 - 554-8565 
or use http://www.glbs.com 

to download a fully functional demo. 



Coming soon SmartPATCH as a stand alone application! 

* Based on Oakley Publishing Company reader survey. May 1996. Microsoft, Windows, and the Windows logo are registered 
trademarks of Microsoft Corporation. InstallShield is a registered trademark of InstallShield Corporation. 


The Ultimate Multimedia 
Playground! 

FXTools Professional features 
eight of the HOTTEST multi- 
media components available. 

Display images, text, shapes, 
and video with 100 main, transi¬ 
tion, and dissolve effects includ¬ 
ing wipes, blinds, splits, and rolls. 

Displays 10 image formats including BMP, TGA, TIF, PCX, 
JPEG, and PNG. Displays video with effects. Supports WAV 
and MIDI sound. 3D fonts with block shadows, 3D borders, 
rotated text, odd shaped hotspots, gradient fill styles, unlimit¬ 
ed composition features, and more! 

FXTools extends the capabilities of today’s most advanced 
visual development tools. Seeing is believing. Obtain a free 
copy of the FXTools Professional demo from the internet 
http://www.imagefx.com or CompuServe (Go IMAGEFX). 

Use FXTools to breathe life into your applications. FXTools 
is the perfect tool for multimedia development, interactive 
demos, presentations, kiosks, training and CD-ROMs. 
Includes 32-bit ActiveX and 16-bit VBX controls. Only $399! 


imageFX 

3021 Brighton-Henrietta Rd. Phone: 716-272-8030 
Rochester, NY 14623 USA Fax: 716-272-1873 

http://www.imagefx.com 
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We thought about 
getting President 
Clinton to speak at 
our D.C. conference. 

But we figured 
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Can't find that Tech Tip from a past 
issue? The Windows Developer's 
Journal CD-ROM with full search 
capabilities is now available. See page 38 
for more information. 



Edited by LeorZoiman 


Please send us your best tricks and 
hacks - those clever pieces of code to 
make things work the way they should! 
You'll receive at least $50 for each tip 
that we print. 

Send your submissions: 

- via the Internet to: 
leor@bdsoft.com 

- or by regular mail to: 

Leor Zolman 

74 Marblehead Street 
North Reading, MA 01864 


Change Directory and Get Current Directory 

in Windows 95 


J. G. Owen 
71121.625@compuserve.com 

Everybody knows by now that Win95 comes with long filenames and old-DOS- 
compatible short filenames. Each and every file has approximately one of each, and 
various new Win95-specific i nt 21h calls support long names (These calls are docu¬ 
mented in Microsoft Press's Programmer's Guide to Microsoft Windows 95; also see 
Robert Mashlan's "Using Long Filenames from 16-Bit Code" in the April 1996 WDJ). 

Naturally, directory names also have the new Win95 dual nature, and this leads to 
the interesting undocumented behavior demonstrated by the testcwd.c program 
(Listing 1). In my innocence, I assumed that the new 7147h GetCurrentDi rectory call 
would return the long name, but sometimes it doesn't! Instead, Win95 apparently 
keeps track of the SetCurrentDi rectory system call (713bh) used to get to the directo¬ 
ry, and then returns the name used in that call. 

Thus, you might create a test directory named 

A Long Directory Name 

like I just did, the short name of which is, as it happens, al ongd-T. Then you can try 
either name: 

testcwd "A Long Directory Name" 

Wgetcwd result: E:\GREG0R\ficciones\win95\A Long Directory Name 
testcwd alongd~l 

Wgetcwd result: E:\GREG0R\ficciones\win95\alongd~l 

and voila! Win95 remembers how you got there and responds in kind! Helpful, no? 
And note that in the second example, the complete path includes a long filename 
(f i cci ones); that is, it's keeping track of the whole thing. So let's see what happens if 
I use the short form for f i cci ones: 

testcwd E:\GREG0R\FICCI0~l\win95\alongd~l 
Wgetcwd result: E:\GREG0R\FICCI0~l\win95\alongd~l 

or even better: 

testcwd E:\GREG0R\FICCI0~l\win95\aL0NGd~l 
Wgetcwd result: E:\GREG0R\FICCI0~l\win95\aL0NGd~l 



Leor Zolman teaches hands-on seminars on C/C++ programming and UNIX. His first 
book, Illustrated C, was published in 1992. Contact Leor at the addresses shown at 
left, or visit the BD Software On-Site Training page at www.tiac.net/users/leor/bds for 
information about his C and C++ seminar offerings. 
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Listing 1 testcwd.c 


/* 

* TESTCWD.C. Fri 05-03-1996. Compiled with TURBO C 2.0 (1988) 
*/ 


JUST00S7 

); 


#include <stdio.h> 
//include <dos.h> 
//include <direct.h> 
#include <string.h> 
//include <stdlib.h> 


int w95(void) { 
static char longname[]-"U"; 
char shortname[13]; 
if (jjsmajor < 7) 
return 0; 


struct SREGS segregs; 
union REGS regs; 


/* I had some problem with 
the recommended procedure so... */ 


void dosseg(void) ( 
int86x(0x21,&regs,&regs.Ssegregs); 

} 


//define MAX95PATH (280) /* probaby really 260, but maybe 
more; actually you’re supposed to do a call_ */ 


regs.x.ax - 0x71a8; 
segregs.ds - FP_SEG(longname); 
regs.x.si * FP_0FF(longname); 
segregs.es - FP_SEG(shortname): 
regs.x.di - FP_0FF(shortname); 
regs.x.dx - 0x0000; 


j ******************************************************** 

Wchdir; return -1 if bad else 0 
****************************★******•*■*■*:**★ + ***★■*■*********★ / 

int Wchdir(const char *path) { 
regs.x.ax- 0x713b; 

regs.x.dx- FP_0FF(path); 

segregs.ds- FP_SEG(path); 

dossegO; 
return 

regs.x.cflag ? -1 : 0; 

) 

enum { 

WIN95RUNNING-1, 
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dossegO; 

return 

regs.x.cflag ? 
JUSTD0S7 ; 

WIN95RUNNING; 

} 


j **************************************** 

Emulates TC getcwd; (DOS omits drive, 
colon, slash.) 

0123 

c:\ 

***************************************** j 

char *Wgetcwd(char *buf, int buflen) ( 
enum { 

NAMEl-3 

); 

char apath[MAX95PATH+NAMEl]; 

getcwd(apath,MAX95PATH+NAME1); 

I* Wastefully use the old TC call to get the drive. */ 

regs.x.ax- 0x7147; 

regs.h.dl- 0; /* this drive. */ 

regs.x.si- FP_0FF(apath J+NAMEl; 

segregs.ds- FP_SEG(apath); 

dossegO; 

if (regs.x.cflag) 
return NULL; 

if (buf) ( 

if (buflen<(strlen(apath)+l)) 
return NULL; 

strcpytbuf.apath); 
return buf; 

} 

return 

strdup(apath); 


/********************************************************* 

★ ★★★■ft*************** ************************ ************** / 

void malndnt argc, char *argv[]) { 
char buf[MAX95PATH]; 
switch(w950) ( 
case JUST00S7; 

printf("DOS 7 but not W95"): 
exit(7); 

case 0: 

printf("No W95"): 
exit(l); 
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Win95 remembers the variant case in a LONGd~l! But then let's 
just do 

testcwd “A Long Directory Name” 

Wgetcwd result: E:\GREGOR\FICC10~l\win95\A Long Directory Name 

again, and look: Win95 remembered the last time I mentioned 
FICCKM in a SetCurrentDi rectory call and replicates it! This 
could get complicated. 

Oh well. The point of it all, I would guess, is to placate 
programs that expect SetCurrentDi rectory and 
GetCurrentDi rectory to match, or else they will generate an 
error. Since only new programs would do this, and they 
would presumably know all about the new GetFul 1 PathName 


Listing 1 testcwd. c — continued 


) 

if (argc >1) ( 
if (Wchdir(argv[lD)) { 
printfCNo such directory?”); 
exit(2): 

} 

Wgetcwd(buf, MAX95PATH); 
printf("Wgetcwd result: %s\n",buf); 
WchdirC.."); /* go back. */ 

1 

1 

/* End of File */ 


and GetShortPathName (Win95 DOS 7160h), it's still a little 
puzzling. 

Win95, of course, knows better. For example, if I use the 
Win95 DOS command CD ALONGD-l, the prompt (as per my 
PROMPT $P$G) shows the correct long name. Perhaps Win95 
does a GetFul 1 PathName before doing the CD. 


Figure 1 Script to produce .lib 


#! /bin/ksh 

# makelib dllfile 

# creates the following files: 
f - dllfile.def 

# • dllfile.exp 

# - dllfile.lib 

DUMPBIN /EXPORTS Jl.dll >*l.tmp 

# now convert to DEF file format 
echo LIBRARY \”$1.DLL\” >Jl.def 

echo DESCRIPTION V’Automatically converted DEE file\" »Jl.def 
echo EXPORTS »$l.def 

awk ’ 

/ordinal ‘hint/ { grabflag - 1; getline: next 1 
/Summary/ { grabflag - 0 } 

{ if (grabflag) print $3 1 ’ tl.tmp >>$1.def 

# create LIB and EXP files 
LIB /DEF:$1.def /0UT:$1.1ib 
rm tl.tmp 
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Creating a Visual C++ .lib 
from a DLL 


Claus Brod 
Aidlingen, Germany 


I just read Ron Burk's article on 
"Building Win32 DLLs the Right Way" in 
the August 1996 issue of Windows 
Developer's Journal. It proved to me that 


we're not the only ones who are baffled 
by the strange export/import mecha¬ 
nisms in the Windows world. We're com¬ 
ing from the UNIX side of things, so this 
is a major culture shock for us anyway. 

One of the nuisances mentioned in 
that article is that there is no direct way 
to create an import library from a DLL. 
We have run across the same problem, 
and I wrote a small script (see Figure 1) 
which does the job for us. The script has 
several shortcomings, but it does what 
we needed. 
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software pro¬ 
grams. 

System Commander also identifies boot record 
and master boot record viruses and deletes 
them. It provides tamper proof, system security. 
Your private password protects any or all of your 
operating systems from unauthorized access. 
System Commander is only $99.95 and 
comes with an unconditional 60 day 
money back guar¬ 
antee. *Call now 
and have it on 
your desk tomor¬ 
row morning! 


"System Commander 
is a blooming miraclef 
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Unlike drivers and TSRs, System 
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eliminates any possible clash between 
System Commander and your OSes or 
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The script first dumps all the export¬ 
ed symbols in the DLL using DUMPBIN, 
then massages the output into . def file 
format using a small awk script. Using 
the . def file, LIB can produce an import 
library for the DLL. 

I used ksh and awk scripts because 
we work with a set of UNIX tools on 
our PCs. You could also use other 
scripting languages such as perl. 

This script is meant to be used with 
Visual C++. It doesn't know about 
DATA entries in the . def file because we 
simply didn't need this functionality. 

Tech Tips Letters 

I noticed the tip about 
WI N32_LEAN_AND_MEAN in "Tech Tips," 
March 1996. I think it's worth noting 
that there's another such define: 

//define WIN32_EXTRA_LEAN 

That does the same thing, but for a dif¬ 
ferent set of header files in windows.h. 
For fastest builds, I #def i ne both 
WIN32_LEAN_AND_MEAN and 
WIN32_EXTRA_LEAN. 

Take care, 

Wayne Vucenic 
wayne@hawaii.adb.com 

Thanks for the interesting tip 
("Displaying System Messages," April 
1996), but the sample code provided 
contains a potential bug: CreateFi 1 e() 
returns INVALID_HANDLE_VALUE (i.e., -1) 
upon error. In the sample provided, 
Cl oseHandl e () will be called even if the 
file could not be opened. 
CloseHandle( ) probably checks the 
handle itself, though. 

Peter J. Neutelings 
pne@via.nl 

Does anyone know how to make a 
program "immortal?" We are trying to 
make an application immune to 
taskmon.exe's End Task button. Any 
suggestions? 

T. Smith 

MSMAlL8.SMITPniO@TSOD.LMIG.COM 
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Compiler Benchmark: Iterators 

Ron Burk 


eE3= 

Borland C++ v5.0 

Symantec C++ v7.2 

Visual C++ v4.1 


Watcom C++ vl 0.6 


Visual Age for Windows C++ v3.5 


This month's benchmark uses another section of Arch D. Robison's OOPACK 
suite to measure how well Win32 compilers generate code. This interesting set of 
benchmarks checks to see how much faster the code generated for an algorithm writ¬ 
ten in C is than the equivalent algorithm implemented in an object-oriented style 
with C++. Ideally, the ratio is 1.0, which means that the compiler's optimizer is good 
enough that you pay no penalty for writing object-oriented code in C++ rather than 
procedural code in C. 

I compared 32-bit Windows compilers from five different companies. The compil¬ 
ers and versions used were: Visual C++ v4.1, Borland C++ v5.0, Watcom C++ vl0.6, 
Symantec C++ v7.2, and Visual Age for Windows C++ v3.5 (IBM). The compilation 
options used are shown in Table 1. You can get the original benchmark from Arch D. 
Robison's Web page at http://www.kai .com/oopack/oopack.html, or get the slightly 
altered benchmark used here from our Web page at www. wd j. com. For each measure¬ 
ment taken, I ran the benchmark three times and took the fastest score. 


Iterators 

A C++ iterator is a class that encapsulates the work of iterating through the ele¬ 
ments of some set of data. For example, you might create an iterator class that lets 
you traverse the elements of a doubly-linked list. Hiding the details of how such ele¬ 
ments are linked together is a sound programming practice, but how much extra 
overhead does that require? Ideally, with judicious use of inline member functions, 
you would be able to build C++ iterators for common data structures that were just 
as efficient as less structured methods (such as directly accessing the link fields in a 
linked list). Whether or not you can achieve that ideal depends to a large degree on 
how good your C++ compiler is at optimizing. 

In this benchmark, a very simple iterator is used to traverse an array of numbers. 
The iterator class consists of little more than a pointer to the array, the current index 
into the array, and the size of the array. The class looks like this: 


// Index of current element 
// 1 + index of last element 
// Pointer to array 


class Iterator { 
private: 

int index: 
const int limit 
DATA * const array; 
public: 

DATA look!) {return arraylindex];} 
void nextO (index++;l 
int doneO {return index>=limit;} 
Iterator{ DATA* arrayl, int limitl ) 
array(arrayl), 
limit!limitl), 
index(O) 

{} 

1 : 


As you can see, everything is inline here, giving the compiler every opportunity to 
optimize away the cost of using the class. 

The following function exercises the iterator by using it to compute the dot prod¬ 
uct of two arrays: 


Ron Burk is the editor of Windows Developer's Journal. You can reach him at 
70302.2566@compuserve.com or http://ourworld.compuserve.com/homepages/RonBurk. 
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DATA A[N]; 

DATA B[N]; 

DATA IteratorResult; 


Table 1 Compiler options used 

Compiler 

Options 

Borland C++ v5.0 

bcc32 -02 -OS -pr -al6 -5 
bcc32i -02 -OS -5 

Visual C++ v4.1 

cl /02 /G5 

Watcom C++ vl0.6 

wcl386 / otexan 

Visual Age for Windows v3.5 

icc /G5 /O+ 

Symantec C++ v7.2 

sc -5 -o -mn 


void IteratorBenchmark::oop_styTe() const 
{ 

DATA sum = 0; 

fort Iterator ai(A,N), bi(B.N); 

lai.donet); ai.nextt), bi.nextt) ) 

{ 

sum += ai.look()*bi.look(); 

} 

IteratorResult = sum; 


In this example, DATA is a typedef; I first 
ran the benchmark with DATA defined to 
be i nt, and then with DATA defined to be 
double. This is perhaps not the most 
realistic use of iterators, but it should be 
at least as easy to optimize as more typ¬ 
ical implementations. To measure the 
penalty, if any, for using this OOP-style 
implementation, the previous code is 
compared to a simple C-style imple¬ 
mentation: 

void IteratorBenchmark::c_style() const 
1 

DATA sum = 0; 

fort int i—0; i<N; i++ ) 
sum += A[i]*B[i]; 

IteratorResult = sum; 

1 

Benchmark Results 

Figure 1 shows benchmark results 
using ints, and Figure 2 shows the 
results using doubles. Visual C++ v4.1 
was the only compiler to achieve a ratio 
of 1.0 or lower, meaning it was able to 
optimize away the overhead of using 
the C++ class to encapsulate iteration. 
Visual C++ also provided the fastest 
overall execution time with one excep¬ 
tion — IBM's Visual Age for Windows 
C++ v3.5 produced the fastest numbers 
for the C-style implementation. This is 
not the first time IBM has produced fast 
absolute results for the procedural 
implementation, but failed to optimize 
the object-oriented style code sufficient¬ 
ly- 

Borland C++ produced lousy num¬ 
bers unless you used their optimizing 
compiler (bcc32i .exe), which turned in 
quite respectable times second only to 
Visual C++. If you are using Borland 
C++, you owe it to yourself to try 
using their optimizing compiler. This 
series of benchmarks so far indicates 
the "normal" compiler is likely to gen¬ 
erate below-average code, while the 
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optimizing Borland compiler is likely to generate quite good 
code. For any specific case, however, you simply have to 
measure the speed to know which compiler is best. 

Summary 

My opinion of Visual C++'s code generation quality has 
risen as a result of this benchmark series so far. However, I still 
maintain that it is important to make measurements before 


talking about efficiency. The task of generating optimal code 
for a language as complex as C++ on a processor as complex 
as the Pentium is quite complicated. Add to that the fact that 
programs often spend 90 percent of their time in 10 percent of 
their code, and making measurements (rather than guessing 
or trying to reason it out) becomes the only reasonable path 
towards improving your program's speed. □ 


Ratio of C++ to C 


Ratio of C++ to C 




■ C ■ - c.. 


Figure 1 Iterator benchmark using ints 


■ =c JI-C++ 


Fi g U re 2 Iterator benchmark using doubles 
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Borland’s Design Tools 5.0 





Ron Burk 


Borland C++ Development Suite with Design Tools 5.0 is the latest version of the 
Borland compiler suite with one key addition: an integrated version of Together/C++, 
an object modeling tool from Object International. I spent some time with the initial 
release of this tool for C++ designers, and this article provides an overview that can 
help you decide if it's something you should investigate for yourself. 

What is it? 

Formerly available as a standalone product, Together/C++ is now thoroughly 
integrated with the Borland IDE. The visual core of this add-on is an "object model 
editor," a graphical view of your C++ classes and their relationships. You can reverse 
engineer existing C++ code to understand it (Together/C++ parses the code, deter¬ 
mines the classes and their relationships, and displays them graphically). You can 
design new classes in the object model editor and it will automatically generate the 
skeletal C++ code for you. You can associate structured documentation with each 
class (the information gets stored in special comments in the code). You can construct 
"scenarios," which are a kind of graphical walk-through of a specific class member 
function. You can generate documentation for your classes in several different for¬ 
mats (RTF, HTML, etc.), though I have not yet investigated this last feature. 

Designing with Together/C++ 

I happened to have a moderately complex C++ design project at hand, so I sat 
down to enter it into the new Borland tool. My design of this project to date resided 
in diagrams I created in Visio, a general utility for diagrams. Using Visio for sketch¬ 
ing designs had proven quite tedious, so I was interested to see if Together/C++ 
would make creating class diagrams much easier. 

I started the Borland IDE and created a new project. Although I'm nowhere near 
ready to generate code, the integrated nature of the tool requires you to have a 
Borland project to work with. From the IDE, it's not obvious how you start up the 
Together/C++ object model editor. The trick is to right-click your executable from 
the project view, select the View menu item, and then you will see several different 
views offered by Together/C++. Each of these represents a particular style of object 
diagramming: Coad object model, OMT object model, or unified object model. 

I have a cavalier attitude toward object modeling methodologies. I need very basic 
diagrams that show classes, inheritance relationships, and perhaps aggregation rela¬ 
tionships (e.g., class TWindow contains a pointer to an instance of class TClient). The 
Coad object model works fine for my purposes, though I'm sure I don't exercise all of 
its features or conform to all of its recommendations. The basics of the Coad model are 
self-explanatory (see Figure 1). Each class is in a box with rounded comers, where the 
class name is at the top, followed by a list of attributes (data members), followed by a 
list of methods (member functions). Inheritance is shown by drawing a line between 
the two classes, with a funny connection point in the middle. Other relationships can 
be shown by lines of other colors and with other funny connectors or endpoints. 

I was not able to figure out how to use the tool without looking at the documen¬ 
tation, but the online help file contained a decent tutorial that got me going in about 
15 minutes. Creating a new class consisted of clicking a toolbar button and entering 
the class name. I could then right-click on the class diagram to add individual attrib¬ 
utes or methods. Most obvious drag-and-drop techniques worked — I could drag 
the class to a new position, reorder attributes or methods by dragging, move or copy 


Ron Burk is the editor of Windows Developer's Journal. You can reach him at 
70302.2566@compuserve.com or http://ourworld.compuserve.com/homepages/RonBurk. 
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attributes or methods between classes by dragging, and so on. 
It was an order of magnitude easier to draw basic object dia¬ 
grams with this tool than with Visio. In fact, given my limited 
artistic ability, I found Together/C++ faster than using a 
whiteboard or pencil and paper! The folks who designed this 
obviously did a little work on "the routing problem." I often 
found that the tool arranged the objects and routed lines 
between them so well that I was discouraged from doing any 
rearrangement myself. Even when I loaded a glob of existing 
code for reengineering, getting the ordering and positioning 
of a diagram into a nice form was quick and painless. 

One problem with CASE tools is that they can get in your 
way. If you've ever used a BASIC editor that forbids you to 
leave the current line until it is free of syntax errors, you know 
how irritating overly helpful software can be. I immediately 
discovered that Together/C++ is at the opposite extreme. It 
obviously knows enough C++ syntax to extract class relation¬ 
ships from existing code, yet it did not complain about any 
semantic errors or inconsistencies in what I entered. As I 
entered the declaration for the first method in the first class, its 
return type and arguments referred to other classes I had not 
yet defined. No problem. After an hour of use with nary a 
complaint from the object model editor, I entered a method 
declaration of "int Foo(;" just to verify that it really was check¬ 
ing some minimal syntax (it was). Although Together/C++ 
associates each class with some source file, and may modify 
that source file as you make changes in your diagrams, it was 
extremely tolerant of other tools. I was able to task switch to 
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my DOS editor, edit the source files Together/C++ was using, 
then return to the IDE and see the class diagram redrawn to 
reflect my changes! 

The object model editor is integrated with the normal source 
code editor in the IDE, so you can click on a class method and 
pop up a window to edit the source for that method. To some 
degree, you can use the object model editor as a replacement for 
the IDE's "Class Expert" view. It does not know much about 
Windows-specific features such as window message dispatch 
tables, but it has far fewer restrictions, since it works with most 
any C++ classes, and not just those generated by App Expert. 

Scenarios 

The object model editor makes it fairly easy to interactively 
create and modify object-oriented designs, but just identifying 
the classes and their attributes and methods is only part of the 
design problem. When you start to write the code behind the 
diagram, you quickly run into problems the initial design did 
not take into account. You can solve many of these problems at 
the design stage by walking through how the object methods 
work and how the objects interact with each other at runtime. 

Together/C++ provides a "scenario editor" that lets you 
visually capture reasoning about how your objects work. The 
basic idea is that you pick a specific task that will happen at 
runtime, such as "locate the customer record." Starting with 
whatever class method handles this task, you enumerate the 
steps that happen and what objects they involve. 

Figure 2 contains an example of working with the scenario 
editor. The left-hand pane displays the objects involved in the 
current scenario. Beneath these objects are a series of lines; 
you can think of these as lines of pseudo-code that you read 
left-to-right and top-to-bottom. These lines are not free-form 
text, but are selected from a small set of operations, such as 
calling a method in another object, standard pseudo-code 
statements (IF, WHILE, etc.), and so on. The right-hand pane 
contains edit controls where you can enter free-form text to 
accompany the more rigid information in the left-hand pane. 
The scenario editor is integrated with the object model editor. 
You can easily get to one editor from the other. The object 
model editor puts an underline beneath those class methods 
for which you have created one or more scenarios. The scenar¬ 
ios are not useful just for finding problems in the design; they 
also provide useful design-level documentation. 

You can print from either editor, but this is really a tool you 
will want to use interactively. In fact, I think Borland should 
offer a modified read-only version of Together/C++ that class 
library vendors can ship with their products, allowing cus¬ 
tomers to interactively browse both classes and scenarios. This 
would be more useful than much of the class library docu¬ 
mentation I have seen. 

Problems and Drawbacks 

I was pleasantly surprised by several aspects of how 
Together/C++ works. On the other hand, I found plenty of 
room for improvement in the details of the implementation. 
The user interface flouted Windows conventions in important 
ways, which is very irritating if you are an experienced 
Windows user. The most blatant example of this is in the object 
model editor. Most Windows programs support an interaction 
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model in which you select one or more items, then select an 
action to apply to those items. Unfortunately, the object model 
editor implicitly selects whatever item is currently under the 
cursor. That means that only one item can ever be selected at a 
time, so if you need to apply an action to several items, you 
have to do so one at a time. For example, suppose you have cre¬ 
ated class Base with nine methods, and now you want to create 
class Deri ved, which overrides eight of those methods. It would 
be natural to want to just select the eight methods in the Base 
class and drag a copy to the Derived class. In Together/C++, 
you must perform eight separate drag-and-drop copy opera¬ 
tions to do this. In an editor that often had an uncanny "do 
what I mean" ability, this limitation stuck out like a sore thumb. 

The object model editor did not provide fly-by hints for its 
toolbar buttons, a feature I sorely missed during the first 
hours of usage; I hate to read documentation. The integration 
between the diagram and the source code was sometimes dis¬ 
concerting; I was impressed that I could task switch to my 
DOS text editor and make source code changes without hurt¬ 
ing the Together/C++ session at all. However, when I 
returned to Together/C++, it did not rescan the source and 
redraw the changes I had wrought until I performed an action 
such as examining the properties of a class. The tool should 
probably check for modified files each time it loses and 
regains the input focus. I could not figure out from the docu¬ 
mentation how to manually force a rescan. 

The tool is extensible in several ways (how it parses code, 
how it generates code, how it generates documentation), but 


these may require you to read and write arcane syntaxes in . i ni 
files. The documentation was not at its best in these areas, so I 
suspect few programmers will actually go to the trouble to take 
advantage of what extensibility there is. It took me more than 
an hour to figure out how to tweak the .ini options so the pars¬ 
er would identify aggregate relationships the way I wanted. 

There are the usual sorts of minor glitches and omissions. 
Undo/redo is available for some actions but not for others. 
Hitting Tab in a dialog might jump you two fields down 
instead of just to the next field. When copying an attribute or 
method between classes, the tool insisted on asking me if I 
really wanted to do this. Since you can't copy more than one 
item at a time, I quickly tired of this dialog box (I later found 
an option to turn this off, buried in the .ini file). Apparently, 
something that I do a lot of (create an abstract base class and 
then derive classes that override all or most of the base class 
methods) is not something the designers of Together/C++ do 
very often, or else they know of some less painful way to 
accomplish the task. Of course, you can always do a cut and 
paste in the source code itself and then pop back to the object 
editor and let it notice your changes. I suppose that's a tribute 
to the flexible source code interface of this tool, but it's no 
substitute for offering the equivalent operations visually. 

Summary 

With an estimated street price of $849.95 ($599.95 to 
upgrade from Borland C++ 5.0), this is the high end of the 
Borland C++ product line. Although I looked at only 
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Figure 1 


The object model editor 


Together/C++ here, the package 
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ever come with Borland C++: 
CodeGuard 32/16, PVCS Version 
Manager, InstallShield Express, and 
AppAccelerator for Java. 

I found three key advantages in 
Together/C++. First, it made the chore 
of transforming my mental images to 
diagrams into something dangerously 
close to fun! Second, the scenario editor 
actually encouraged me to thrash out 
more issues at the design stage — 
issues that I would normally uncover 
by pounding out code as soon as I had 
a halfway plausible set of classes. 
Finally, because Together/C++ can 
read my code (not just generate code 
for me), and because it largely lets me 
do things my way (rather than enforc¬ 
ing a methodology), I believe there's a 
good chance I really can use it through¬ 
out the life cycle of a moderately com¬ 
plex software project. That means that 
as my design changes, I will keep my 
design diagrams up-to-date (why not? 
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— Together/C++ does most of the 
work). It also means that as my design 
changes, I will update my design notes 
(I have to do most of the work, but the 
scenario editor makes it appealing). 
The ability to read and work with my 
code without imposing any serious 
restrictions on it was crucial for me. 

I used the initial release of this prod¬ 
uct for only a matter of days, so my real 
test of this tool will be whether or not 
I'm still using it in six months, and to 
what degree. I'm sure that more exten¬ 
sive use will uncover problems and lim¬ 
itations I did not encounter in my initial 
sessions. It's not something I would use 
on small or simple programs, but 
Together/C++ seems very appealing 
for any project too complex to easily 
keep in your head all at one time. If you 
design complex or moderately complex 
C++ programs, you should investigate 
this tool. □ 
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• display modes: ASCII, Decimal, Hexadecimal 

• up to two simultaneously running measurements in Windows 

• IRQ0..IRQ15 and any port address 

• includes special adapter, cabel and 16bit serial board 


SuperMonitor for DOS only $398 
SuperMonitor for Windows only $498 
SuperMonitor for DOS+Windows only $768 
SuperMonitor for Windows Twin only $748 
SuperMonitor for DOS+Windows Twin only $998 

*Windows=Windows 3.x + Windows 95 
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RS232-Toolkit, SuperCom for 


ipe 

DOS, Windows, OS/2, NT, WIN 95 

for MS C/C++, Visual C++, Turbo/Borland C/C++, 
Turbo/Borland Pascal, Delphi, IBM C/C++, WATCOM C/C++ 

SuperCom is the development tool for exacting serial communication 
software. That means high data security and hignest transmission speed. The 
SuperCom libraries are fast even in a multitasking operating system like 
Windows 3.x, NT, Windows 95 or OS/2. The same programming interface is 
used among different languages and operating systems. 

• Interrupt driven: transmission, reception, linestatus, • Language independent DLL (Windows, NT, WIN95, 

modem status. Up to 115,200 bps. OS/2) which can be used for simultaneous transfers 

• UARTS: 8250,16450,16550 FIFO, any port address, by applications, 

• Simultaneous COM_1 ..COM_36 (and unlimited). • Multiserial board support (AST, ARNET, DigiBoard 

• Direct register programming*. Interrupt-Sharing. PC IX, HOSTESS, STARGATE). Reduces loading of 

• Flow control: RTS/CTS, DTR/DSR, XON/XOFF and CPU through support of intelligent DigiBoard PC/Xe, 


user defined. ANSI, TTY, VT52. 

• Protocols: ASCII, XMODEM. XMODEM/CRC, 
YMODEM, YMODEM/BATCH, ZMODEM. 

• Timer, Ctrl-Break and Exception handling. 

• Multitasking support (Windows, NT, WIN95, OS/2) 

• User Event Routines under DOS and Windows. 

• Under Windows user can even post messages to 
the application using PostMessage. 


PC/Xem, PC/Xi boards (up to 7 Boards/PC !!!). 

• Modem support, RS422/485 support. 

• Supports 286 DOS-Extender (e.g. PharLap, Borland) 

• NO ROYALTIES. No resident drivers*. Just link the LIB. 

• FREE technical support. FREE demo 

• Full source code (C or Pascal and optimized ASM). 

• SuperCom++ (C++ or Pascal OOP) included. 

• Protected Mode Interface (Windows) included. 


C/C++ or Pascal package for DOS only $299 
C/C++ or Pascal package for Windows, OS/2 or NT each $399 
C/C++ or Pascal combo pack for DOS+Windows only $528 
C/C++ combo pack for DOS+Windows+OS/2 only $799 
C/C++ combo pack for DOS+Windows+NT only $799 
C/C++ combo pack for DOS+Windows+OS/2+NT only $999 
’Under DOS and Windows. Windows=Windows 3.x + Windows 95 16bit, 

NT=Windows NT + Windows 95 32bit _ __ 

VISA, MC, COD. 



NEW!!! COMM-Enhancer for Windows 3.x 

Forget the Windows 3.x COMM API limitations. Use the COMM-Enhancer and extend 
your Windows 3.x COMM API based applications. Up to 40 channels (COM1...COM40!) 
and up to 115.200 bps. It uses SuperCom 3!!! 

Price $299 (together with any SuperCom combo supporting Windows 3.x $199!) 


ADONTEC Computer Systems Ltd 

Hoelderlinstr. 32 

D-75433 Maulbronn, Germany 

Phone: +49-7043-9000-20 
FAX: +49-7043-9000-21 


Fine Line International 
7000 Malone Rd, Forestville 
CA 95436, USA 

Phone:+1-707-887-3400 
FAX: +1-707-887-1015 


In Israel, call: 

Phone: +972-3-924-3555 
FAX: +972-3-924-3132 

In Italy, call: 

Phone: +39-49-8713444 
FAX: +39-49-8713055 
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R&D Books 

for the serious software professional 


Tools for 
Code Management 

Using Make, Debuggers, Revision 
Control, Profilers, and Lint 

by Larry Reznick 
Improve your code with the best 
tools for each stage of 
software development 
$29.95 ISBN 0-87930-435-9 



Windows Programming 
with Shareware Tools 

A Developer's Resource Kit 

by Victor Volkman 
Immediate access to the best 
Windows programming tools, 
to save hours on Windows 
software development and testing 
$44.95 with CD-ROM 
ISBN 0-87930-434-0 

Writing Windows VxDs 
and Device Drivers 
2nd edition 

Programming Secrets 
for Virtual Device Drivers 

by Karen Hazzah 
Uncover the alternatives for 
interfacing your Windows 
applications to hardware 
$49.95 with disk ISBN 0-87930-438-3 
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Writing 
Windows VxDs 
and Device Drivers 



FreeDOS Kernel 

An MS-DOS Emulator for 
Platform Independence and 
Embedded Systems Development 

by Pat Viliam 
Master operating systems 
development for PCs 
and embedded systems 
$29.95 with disk ISBN 0-87930-436-7 


Using PCX Graphics Files 

The Programmer's Definitive 
Guide to PCX File Formats 

by Roger T. Stevens 
Programming tricks and tools for 
creating, viewing, and modifying 
PCX graphics 
$49.95 with CD-ROM 
ISBN 0-87930-432-4 
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RPC for NT 

Building Remote Procedure Calls 
for Windows NT Networks 

by Guy R. Eddon 

Solve problems more quickly using 
distributed computing and Remote 
Procedure Calls 

$39.95 with disk ISBN 0-87930-450-2 


Keith E. Bugg 


Building 
Windows 
Help Files 


Building 

Windows Help Files 

by Keith E. Bugg 

Learn the nuts and bolts of writing 
Windows Help applications 
$29.95 ISBN 0-87930-439-1 


| 


You can find R&D Books at these fine bookstores: 


CALIFORNIA 

Annabooks - San Diego 
ASUCLA Bookstore - Los Angeles 
Barnes & Noble - San Jose 
Borders Books - Emeryville 
Chaucer & Co. - Santa Barbara 
Cody's Books - Berkeley 
Computer Literacy Bookshops - Cupertino 
Computer Literacy Bookshops - San Jose 
Computer Literacy Bookshops - Sunnyvale 
Irvine Sci-Tech Books - Irvine 
Kepler's Books - Palo Alto 
Menlo Bookstore - Atherton 
Micro Center - Tustin 
Opamp Technical Books - Los Angeles 
San Diego Technical Books - San Diego 
Stacy's - Palo Alto 
Stacy's - San Francisco 
Stanford Bookstore - Stanford 
USC Bookstore - Los Angeles 
COLORADO 

Barnes & Noble - Ft. Collins 
Softpro - Englewood 
GEORGIA 

Micro Center - Marietta 
ILLINOIS 

Borders Books - Schaumberg 
INDIANA 

Borders Books - Bloomington 
MARYLAND 

Borders Books - Columbia 
Borders Books - Rockville 
MASSACHUSETTS 
Micro Center - Cambridge 
Softpro - Burlington 
MICHIGAN 

Borders Books - Novi 
MINNESOTA 

Barnes & Noble - Roseville 


NEW JERSEY 

Barnes & Noble - Cary 
Barnes & Noble - Paramus 
Barnes & Noble - Princeton 
Borders Books - East Brunswick 
NEW MEXICO 
Page One - Albuquerque 
NEW YORK 

Barnes & Noble - 82nd & Broadway 
Barnes & Noble - 6th at 22nd 
Barnes & Noble - Union Square 
Borders Books - World Trade Center 
Borders Books - Rochester 
Coliseum Books - Manhattan 
McGraw-Hill Bookstore - Manhattan 
OHIO 

Micro Center - Columbus 
Micro Center - Mayfield Hts. 

Micro Center - Sharonville 
Micro Center - Westerville 
OREGON 

Powell's Technical Books - Portland 
PENNSYLVANIA 

Chester County Book Co. - West Chester 
Micro Center - St. Davids 
TEXAS 

Micro Center - Dallas 
Micro Center - Houston 
UTAH 

BYU Bookstore - Provo 
VIRGINIA 

Borders Books - Tyson's Corner 
Computer Literacy Bookshops - Tyson's 
Corner 

Micro Center - Fairfax 
WASHINGTON, DC 
Reiter's Scientific Books 
WASHINGTON STATE 

Barnes & Noble - Bellevue 
Barnes & Noble - Seattle 
Tower Books - Bellevue 


R&l) Hooks, an imprint of Miller Freeman, Ine. *© 

1 fi0 1 \V. 23rd St., Ste. 200 • Lawrence kS (>0046 q 

Web: http: www.rdhooks.eom "5 
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Advanced Uses of the Toolbar 


Eric Heim burg 



Borland C++ v5.0 
Watcom C++ v10.5 


The new toolbar common control in Windows 95 is very versatile, but its documen¬ 
tation and sample programs do not explain how to use its programming interface very 
well. The documentation is especially inadequate in explaining how to use the built-in 
customization features. These features allow the user to add, remove, and reorganize 
the controls on the toolbar. This article explains how the toolbar customization works, 
and also fills in some of the other gaps in the control's documentation. 


A Quick Toolbar Review 

Before covering more advanced features, I will briefly review the basics of using 
the new toolbar common control. The toolbar directly supports only buttons and 
separators (spaces between buttons, which the toolbar treats as little transparent but¬ 
tons). Buttons are "built in" to the toolbar in the sense that the application using the 
toolbar never sees the window handles of the buttons. Instead, the application repre¬ 
sents each button (and separator) with a TBBUTTON structure. The Win32 SDK online 
help incorrectly documents TBBUTTON; it doesn't mention the bReserved field. 
Following is the correct definition of TBBUTTON: 


typedef struct _TBBUTT0N ( 
int iBitmap; 
int idCommand; 

BYTE fsState; 

BYTE fsStyle; 

#ifdef .WIN32 

BYTE bReserved[2]; 
#endif 

DWORD dwData; 
int iString: 

} TBBUTTON: 


When you call CreateToolbarEx() to create a toolbar, you pass it an array of TBBUTTON 
structures describing the order and appearance of each button and separator that 
will initially appear on the toolbar. Once the buttons have been created, this array is 
no longer needed. 

Another parameter you pass to CreateTool barEx() is a bitmap, which the toolbar 
treats as a horizontal row of equal-sized pictures. To indicate which of these pictures 
a specific button should display, TBBUTTON's iBitmap field is a zero-based index into 
this "array" of pictures. Separators don't have pictures, so the i Bi tmap field has a dif¬ 
ferent meaning for them: it indicates the width of the separator in pixels. A value of 
zero for this width causes a default separator size to be used. 

TBBUTTON's idCommand field indicates the ID of the button. When the user clicks a 
toolbar button, it sends WM.COMMAND messages to the window that owns the toolbar, and 
the WM.COMMAND message includes the button ID you specified. Despite the TBBUTTON 
documentation's claim that separators must have an ID of zero, the toolbar actually 
supports separators with non-zero IDs. Although giving IDs to separators seems 
pointless because they cannot be clicked, it is important to give separators distinct IDs 
if they have non-default widths, so that the customization features of the toolbar will 
work correctly, and so that the separator's position on the toolbar can be found later. 


Eric Heimburg is a student at the University of Central Florida, and is employed by a 
contractor group that develops Windows-based training systems for the U.S. Navy. He 
can be contacted via email at heimburg@cs.ucf.edu. 
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Adding Controls Other 
Than Buttons 

The toolbar directly supports only 
buttons and separators, but program¬ 
mers often want to include other con¬ 
trols, such as comboboxes, on the tool¬ 
bar. The standard trick for doing this is 
to create a separator that is the same 
width as the desired control and give 
that separator a unique command ID 
(in the i dCommand field of its TBBUTTON 
structure) so you can locate it. You can 
then use MoveWi ndow() to place the new 
control on top of its "host" separator. 

For positioning and clipping to 
work as expected, any controls appear¬ 
ing on the toolbar should be child win¬ 
dows of that toolbar. Unfortunately, if 
the control is created as a child of the 
toolbar, it will send notification mes¬ 
sages back to the toolbar. This means 
that you would have to subclass the 
toolbar's window procedure to inter¬ 
cept the messages (e.g., listbox selec¬ 
tion notifications) and process them. 

A different method is presented in a 
Microsoft Systems Journal article (August 


1994, "Chicago's Interface Gadgets, Part 
II"; until recently, this article appeared 
on the Microsoft Developer's Network 
CD). This method takes advantage of a 
disgusting property of the built-in con¬ 
trols: both the standard controls and the 
new common controls always send noti¬ 
fication messages to their original par¬ 
ent, even if their parent is changed with 
SetParentO. This seems like a design 
mistake on Microsoft's part, but since it's 
apparently here to stay, you can take 
advantage of it. When you create a con¬ 
trol (e.g., a listbox) that you plan to add 
to the toolbar, make the toolbar parent 
window the new control's parent win¬ 
dow as well. After creating the control, 
however, use SetParentO to change its 
parent to be the toolbar. 

The User Customization 
Features 

The toolbar common control pro¬ 
vides customization features that let the 
user add, remove, and reorder the but¬ 
tons on the toolbar. By shift-clicking on 
a button, the user can drag any toolbar 
button around. The button order can be 


changed this way, and buttons can be 
removed by dragging them off of the 
toolbar. When the user double-clicks on 
an area of the toolbar not covered by a 
button, the toolbar displays the 
"Customize Toolbar" dialog box (see 
Figure 1). Here the user can add or 
remove buttons, change the button 
order, or reset the toolbar to its default 
configuration. 

These customization features are 
available only if you create the tool¬ 
bar with the CCS_AD JUST ABLE style bit, 
and handle several notification mes¬ 
sages. These notifications include 
TBN_GETBUTTON INFO (lets the customiza¬ 
tion dialog obtain string names for each 
button), TBN_QUERYINSERT (to approve or 
deny the inserting of a new button), and 
TBN_QUERYDELETE (to accept or deny the 
removal of a button). 

The TBN_GETBUTTONINFO notification 
is a bit confusing because the docu¬ 
mentation for it is vague and inade¬ 
quate. Some background information 
will help: the toolbar's designers 
implicitly expect every program that 
uses the customization features to have 
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VICTOR 

Image Processing Library 

Speed and power 
processing for all 
popular image 
formats 

Victor Image Processing Library 
DOS $199,16-bit DLL $299, 
32-bit DLL $499 


★ Fast load & save BMP, TIFF, PCX, GIF, TGA, JPEG 
^ Powerful image processing: brightness, 
contrast, sharpen, smooth, equalize, 
create filters, resize, rotate, +++ 

^ Accurate color reduction to optimum, specific, 
or standard palette 

2 Print halftone, diffusion scatter, or color 
^ Scan with all HP scanners 

Visit our home page for demos, pictures, and sample code 
http://www.catenary.com/victor 

Call or fax to order.. .voice: 314-962-7833 fax:314-962-8037 

rCatenary Systems 

470 Belleview St Louis MO 63119 

No royalties Source code available visa/mc/cod. 
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Basic Scripting 


Cypress Enable 3.0 
Basic Scripting for Applications 

A Powerful, complete, royalty free, VBA compatible 
Basic Scripting Language. Cypress Enable Features: 
OLE Automation, small footprint < 200k, Dynamic 
Dialogs, Dialog Editor, Editor/Debugger with source 
code, extensible syntax, save/load compiled code, 
printed and online documentation, huge script 
capacity, On Error, For...Each and With statements, 
easy access to objects, variables and functions in your 
application, extremely powerful API, logical and easy 
to use, integrate in a matter of hours . Supports 16 & 
32 bit Windows, MAC, UNIX and DOS. 60 day money 
back guarantee, 16bit $495, 32bit$595. Free 
whitepaper. Order Today! 1-800-790-4050. 


Cypress Enable has shipped in over 2,000,000 
products worldwide! 



Cypress Software Inc. 

Http://>vww.cypressinc.com , Fax (602) 951-8047 
Phone (602) 922-4883. email cy press'fl'cypressinc.ctim 
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an array (or list) of TBBUTTON structures, 
with one entry for each button that can 
possibly appear on the toolbar. I'll call 
this list the master TBBUTTON list. 

Do not confuse this master TBBUTTON 
list with the list of TBBUTTON structures 
used to initialize the toolbar. The latter 
contained the buttons that should 
appear on the toolbar when it first starts 
up, in the order they should appear. In 
contrast, the master TBBUTTON list con¬ 
tains every possible button whether or 
not it is currently displayed, and the 
order of the buttons in the master 
TBBUTTON list is not important. Actually, 
it's possible to use one list for both pur¬ 
poses if you want the toolbar to always 
start up with every possible button dis¬ 
played. You can simply use the master 
TBBUTTON list as the initial configuration 
list. (This is what most sample pro¬ 
grams do.) 

The purpose of the TBN_GETBUTTONINFO 
message is to ask the program for one of 
the TBBUTTON entries in the program's 
master TBBUTTON list, along with a name 
(a string) for that button. The message 
handler is passed three arguments: a 


zero-based index into the program's 
master TBBUTTON list, an empty TBBUTTON 
structure, and a pointer to a text buffer. 
If the index it asks for is in the valid 
range, it expects the program to fill in 
the TBBUTTON structure (by copying the 
appropriate entry from its master 
TBBUTTON list), place the button's name 


in the text buffer, and return TRUE. If it 
asks for an invalid index, the program 
should return FALSE. 

When the customization dialog 
begins, the toolbar sends 
TBN_GETBUTTONINFO repeatedly, with 
the first message requesting index zero 


continued on page 50 


User double-clicks in 
unused area of toolbar ... 


... to display the built-in 
customization dialog. Toolbar 
must have been created with 
CCS_ADJUSTABLE style. 
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For C and C++ Developers.... 


When the RichEdil Control is not Enough. 


Are you writing a 

• Document Viewer? 

• Multimedia Product? 

• Report Generator? 

• Forms Package? 

• HTML Editor? 

• Email Application? 

• Electronic Book Technology 

• Hypertext Enabled Program? 

• Program with text features? 

Then you need PAIGE. 

PAIGE™ is a library of run-time 
functions you can embed into your 
application. It will add virtually unlimited, 
programmable “rich edit” word processor 
and page layout features to any part of your 
program. 

PAIGE will save you hundreds of precious development 
hours. Better yet with PAIGE’s cross-platform API you can 
support the most popular desktop operating systems. 


IGE is the solution when 
“edit” controls fail. 

Key PAIGE Features_ 

• Cross-platform API 

• Embed anything into text 
• Supports L’nicode Character Set 
• Wrap text m/around graphics 
• Overlay text on graphics 
• Import & Export RTF 
• Full MFC support 
• Royalty Free 


Call: 800-327-6703 


DataPak Software Inc. 


Internet: sales@datapak.com 
www.datapak.com/~ datapak/wdj 


CS: 76424,3027 
AOL: DATAPAK 1 


Ph: 360-891-0542 
Fx: 360-891-0743 


Windows 3.1 • Windows 95 • Windows NT • Macintosh • PowerMacintosh 
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Key Facts 

❖ Add a control (e.g., a listbox) to the toolbar by creating a 
"host" separator of the appropriate width, then position¬ 
ing the control above that separator. 

❖ Give the host separator a unique ID so that it can appear 
in the customization dialog with a meaningful name, 
and so that you can locate its position and size later. 

❖ Giving the host separator a meaningful icon in the cus¬ 
tomization dialog requires some subclassing code 
(Figure 3). 

❖ Keep one TBBUTTON array that contains all the possible 
buttons your toolbar supports, and a separate array that 
contains the subset of buttons to appear at startup. 

❖ Use TB_SAVERESTORE to save the current state of the tool¬ 
bar to the registry. 

❖ Don't use TB_SAVERESTORE to load a toolbar state from the 
registry; instead, use the code in Figure 4. 

❖ A shift-click on a toolbar button only generates 
TBN_BEGI NDRAG/TBN_ENDDRAG if the CCSJDJUSTABLE style 
is set. 

❖ TBN_BEGI NADJUST and TBN_ENDADJUST only get sent when 
the customization dialog is created, not when the user 
drags a button. 

❖ TBSTYLE_ALTDRAG disables the normal shift-dragging. □ 
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continued from page 47 

and each message thereafter asking for subsequent indices, 
until the program returns FALSE. Next, the toolbar places each 
item in one of two listboxes (see Figure 1). Items that are 
already on the toolbar are placed in the right-hand listbox, 
while all other items are placed in the left-hand listbox. Each 
button is shown with its picture next to it, and a gray square is 
used as the picture for separators. 

When processing this message, beware that if the button is 
already on the toolbar, its state flags may have changed since it 
was added to the toolbar. Therefore, the state information in 
your master TBBUTTON list may be incorrect. Make sure to use 
TB_GETSTATE to get the current state of the button. If TB_GETSTATE 
returns -1, the button isn't on the toolbar yet, so it's fine to use 
the state flags in the master TBBUTTON list. 

Finally, there is a bug in the implementation of 
TBN_GETBUTTON INFO. The pointer to the text buffer (pszText) is 
NULL when the TBN_GETBUTTONINFO message is sent in response 
to a user adding buttons from within the customization dia¬ 
log. Therefore, when handling this message, check to see if the 
pszText field is NULL. If it is, point it to a valid char array. Make 
sure the char array is defined as static so that it won't go out of 
scope when the function ends. (It is safe to use one static char 
array for all TBN_GETBUTTONINFO messages because the toolbar 
copies the information out of this array immediately after the 
message returns.) Figure 2 contains an example of handling 
the TBN_GETBUTTONINFO message. 

Using Customization Features with 
Non-Button Controls 

The customization features work great for buttons, but tool¬ 
bars containing other kinds of controls require more work. Like 
the rest of the toolbar, the customization features directly sup¬ 
port only buttons and separators. As I mentioned earlier, you 
can make a control such as a listbox appear to be part of the 
toolbar by creating a separator of the appropriate width, then 
positioning the control above that "host" separator. When the 
user calls up the toolbar customization dialog, that host separa¬ 
tor will appear as one of the items (if you remembered to assign 
it a unique ID), and the user can then add or remove it from the 
toolbar as though it were an ordinary button. Several steps are 
needed to implement this scheme. 

The control should be visible only when its host separator is 
on the toolbar. Also, whenever the user modifies the toolbar, the 
control should be repositioned atop its host. All of this can be 
done in response to the TBN_TOOLBARCHANGE message. In the code 
that handles this message, simply check whether or not the sep¬ 
arator is on the toolbar, and hide or show the control as appro¬ 
priate. If it's visible, reposition the control atop the toolbar, 
using TB_GETITEMRECT to find the separator's screen coordinates. 

The next step is to make the control appear in the cus¬ 
tomization dialog with some kind of meaningful icon and 
label. Though the customization dialog shows only buttons 
and separators, you can effectively add other kinds of controls 
by using the host separators they sit on. As far as the user is 
concerned, the host separator doesn't exist. The other control 
appears in the dialog in place of the host separator. 

If you give the separator its own ID, you can specify a 
label for the separator in response to the TBN_GETBUTTONINFO 
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message. (Separators with IDs of zero always have the name 
"Separator" even if they were given entries in the master 
TBBUTTON list.) This takes care of the label displayed in the cus¬ 
tomization dialog, but this doesn't take care of the picture 
shown to the left of the label. 

No separator can have a picture because the i Bi tmap field is 
used to store the width of the separator. It seems like this 
should be an easy problem to overcome. In response to the 
TBN_GETBUTTON IN FO message, couldn't you change it from a 
separator to a button, changing it back after the dialog is 
done? This doesn't work because the toolbar is redrawn while 
the dialog is still running. Thus, the toolbar would look funny 
until the dialog ended. The only satisfactory way to fix this 
problem is to get down and dirty: you have to subclass the 
dialog and make some small changes. 


safe bet that any code subclassing this dialog will break 
under the next version of the common control DLL. For this 
reason, it is a good idea to check the VERSIONINFO resource in 
COHlctl32.dll to verify that the low DWORD of the file version is 
950 and that the high DWORD is 0x40000. If the DLL is the wrong 
version, don't do the subclassing. Some of the controls will 
have little gray squares instead of their correct pictures when 
viewed in the customization dialog, but at least your pro¬ 
gram will run. 

The customization dialog has two owner-drawn listboxes 
(actually drag-listboxes, but that isn't important for this task). 
To draw each item, the listbox uses information in the item's 
DWORD (accessible with the LB_GETITEMDATA and LB_SETITEMDATA 
listbox messages). The low-order word of each item's DWORD is 


Subclassing the 
Customization Dialog 

The innards of the customization 
dialog are not documented. In fact, it 
appears that the dialog has not been 
"cleaned up" for public use. For 
instance, the "Add" button in the dia¬ 
log has an ID of 1, which is usually 
reserved for the "OK" or "Done" but¬ 
ton. This suggests that the customiza¬ 
tion dialog was originally designed to 
add buttons exclusively, but that it was 
beefed up before it was released. It is a 
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the index of the icon to use (or OxFFFF if it is a separator). If the 
item's ID is non-zero, the high-order word is the item's index 
in the master TBBUTTON list; otherwise, disregard it. 

The first difficulty is deciding when to subclass the dialog. 
The obvious place would be in response to the TBN_BEGI NADJUST 
message, but this message is sent before the dialog is created. 
The first message sent after the dialog's creation is 
TBN_QUERYINSERT, so the dialog can be subclassed there. The 
dialog's window-class name is "#32770" (the same as other 
dialogs). Figure 3 demonstrates how to subclass the dialog, 
and provides the subclassing procedure. 

The purpose of the subclassing procedure is to find the list- 
box entries for the "host" separators, and change the high 
word of their DWORD so they are drawn with a different icon. 
This can be done by intercepting the WM_DRAWITEM message 
(which Windows sends to the dialog to tell it to redraw an item 
in an owner-drawn control). When intercepting a WM_DRAWITEM 
message, the subclass procedure inspects the DWORD of the item 
being redrawn (using LB_GETITEMDATA) to determine its picture 
and index in the master TBBUTTON list. When the item with the 
"host" separator's index is found, the item's picture is checked 
to see if it is OxFFFF (which is what the dialog sets it to initially). 
If it isn't, then the code has already changed the picture and 
can pass this message on to the original dialog procedure 
immediately. If it is still OxFFFF, I use LB_SETITEMDATA to change 
it, then invalidate the item's rectangle with InvalidateRectO. 
All WM_DRAWITEM messages other than the one I changed are 
passed on to the original dialog procedure. 


Figure 2 Handling TBN_GETBUTTONINFO 


/* code to handle the TBN_GETBUTTONINFO notification */ 

TBBUTTON Btns[] - ... /* master TBBUTTON list */ 

//define NUMBTNS x /* // of buttons in Btns[] */ 

LRESULT CALLBACK .export WndProc( HWND hwnd, UINT uMsg, 

WPARAM wParam, LPARAM 1Param ) 

{ 

TBNOTIFY *p; 

DWORD result; 
static TCHAR buf[128]: 

if (uMsg ~ WM.NOTIFY) { 
p - (TBNOTIFY*)1 Pa ram; 
if (p-)hdr.code — TBN.GETBUTTONINFO) { 

/* see if requested index is valid */ 
if (p->iItem < NUMBTNS) { 

/* it is, so fill the struct it passed in */ 
p->tbButton - Btns[p->iItem]; 

/* if this button is already on the toolbar, get * 

* the most up-to-date state flags for it *1 

result - SendMessage(p->hdr.hwndFrom, TB.GETSTATE, 

Btns[p->iItem].idCommand, 0); 
if (result !- -1) 

p->tbButton.fsState - (BYTE)result; 

/* make sure the text ptr. points to a valid * 

* buffer; if it isn’t, point it to one */ 

if (p-)pszText — NULL) { 

p->pszText - buf; 

p->cchText - sizeof(buf) / sizeof(TCHAR); 

} 

/* now that the buffer is okay, copy the label into the buffer */ 
strcpy(p->pszText, "Put Label Here”); 
return TRUE; 

} 

else ( /* invalid index requested */ 
return FALSE; 

) 

} 

} 

} * 


The only other message that needs to be intercepted is the 
WM_DESTROY message, where the dialog is unsubclassed. 

TB.SAVERESTORE 

The TB_SAVERESTORE message can be used to save or restore 
the toolbar's button order in the registry. The information is 
stored in the registry as an array of four-byte integers. The inte¬ 
gers represent the command IDs of the buttons on the toolbar 
from left to right. This organization is simple but sufficient. 

One small flaw in TB_SAVERESTORE is its handling of the spe¬ 
cial case where the toolbar has no buttons. When an empty 
toolbar's configuration is saved, it results in a registry entry 
with a size of zero. When this empty entry is later restored, it 
should configure the toolbar so that it has no controls on it. 
Instead, an empty registry entry is ignored as if the program 
hadn't sent the TB_SAVERESTORE message at all. This is only a 
minor flaw, and it could have useful side effects, but it should 
be documented as behaving this way. 

There is a more serious flaw in how the stored configuration 
is reloaded. The control first removes everything from the tool¬ 
bar, then places the command IDs from the saved configuration 


Figure 3 Subclassing the customization 
dialog 


/* * code to subclass the "Customize Toolbar" Dialog */ 

TBBUTTON Btns[] - ... /*master TBBUTTON list */ 

LONG OldProc - 0; /*var to store dialog's old proc. */ 

//define ID_CB 110 /*command-ID of the combobox */ 

//define IDX.CB 1 /*zero-based index of the combobox 

in the master TBBUTTON list */ 


/* WNDPROC to subclass "Customize Toolbar" Dialog */ 

LRESULT CALLBACK CustomizeProc(HWND hwnd, UINT uMsg. 

WPARAM wParam, LPARAM 1Param) 

{ 

DWORD result; 

DRAWITEMSTRUCT *pDraw; 

if (uMsg — WM.DRAWITEM) { 
pDraw - (DRAWITEMSTRUCT*)1Param; 
if (pDraw->itemData - MAKELPARAM(OxFFFF. IDX.CB)) { 
SendMessage(pDraw->hwndItem, LB.SETITEMDATA, 

pDraw->itemID, MAKELPARAMCSTD_PR0PERTIES, IDX.CB)); 
InvalidateRect(pDraw->hwndItem, NULL, FALSE); 

} 

} 

result - CallWindowProcC(WNDPROC)01dProc, hwnd. uMsg, wParam, 1Param); 
if (Msg — WM.DESTROY) { 

SetWindowLong(hwnd, GWL.WNDPROC, OldProc); 

OldProc - NULL; 

} 

return result; 

} 


/* the code fragment in toolbar parent's window proc that 
subclasses the customize dialog */ 

LRESULT CALLBACK .export WndProc( HWND hwnd, UINT uMsg, 

WPARAM wParam, LPARAM 1Param ) 

{ 

HWND htemp; 

if (uMsg — WM.NOTIFY) { 

if (((NMHDR*)1Param)->code — TBN.QUERYINSERT) { 
if (OldProc — NULL) { 

/* find the customize dig, and subclass it */ 
htemp - FindWindow("//32770", "Customize Toolbar"); 
if (htemp) 

OldProc - SetWindowLong(htemp, GWL.WNDPROC, (LONG)CustomizeProc); 

} 

return TRUE; 

} 

/* process other notification messages here */ 

} 

} 
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onto the toolbar. At this point, it needs to get more information 
about each button, such as which picture to display. The control 
does this by sending TBN_GETBUTTONINFO messages, just as the 
customization dialog does. (In fact, it simulates starting up the 
dialog exactly. It sends TBN_BEGI NADJUST and a number of other 
messages in the same order as the dialog.) The problem is that 
when the TBN_GETBUTTON INFO messages are sent, all the internal 
information in the control is no longer valid. The values 
returned from TB_GETSTATE, TB_GETBUTTON, etc. will be for the 
buttons previously at that position on the toolbar. Since this 
information is no longer valid, using these messages while the 
toolbar is being restored will result in errors. 

How can you work around this problem? The obvious 
solution is to simply avoid using the information retrieval 
functions (TB_GETSTATE, TB_GETBUTTON, etc.) while processing 


TBN_GETBUTTON INFO. But this problem affects more than just 
TBN_GETBUTTON INFO. For some reason (presumably to reuse 
code), TB_SAVERESTORE behaves exactly as if it were starting up 
the configuration dialog — it sends TBN_BEGI NADJUST, 
TBN_QUERYINSERT, TBNJUERYDELETE, and TBNJNDADJUST, as well 
as TBN_GETBUTTONINFO. (The results of these TBN_QUERYINSERT 
and TBN_QUERYDELETE messages are never used.) It is difficult to 
avoid using any button-information commands while process¬ 
ing all of these messages. A different solution is to set a variable 
to TRUE before sending the TB_SAVERESTORE, then set it to FALSE 
immediately afterwards. This variable could be used to tell 
when it is safe to use the button-information commands. This is 
not exactly elegant, however. In my opinion, all this special-case 
code is not warranted by the small amount of work that the 
TB_SAVERESTORE function performs. A cleaner solution (and, in 


Figure 4 A TB_SAVERESTORE substitute 


/*func. to replace the restore ability of TB_SAVERESTORE */ 


Parameters: 

hTB - handle of toolbar being restored 
List - pointer to program's master TBBUTTON list 
nList - number of entries in List 

hKey - handle of key to get value from 

(typically HKEY_CURRENT_USER) 

SubKey - text name of subkey to get value from 
(or NULL to use hKey) 

Value - text name of value 

Note that the last three parameters directly correspond 
to the three fields of the TBSAVEPARAMS structure, which 
is passed to TB.SAVERESTORE. 


void RestoreToolbar(HWND hTB, TBBUTTON *List, int nList, 

HKEY hKey, LPCSTR SubKey. LPCSTR ValueName) 

( 

TBBUTTON Btn, DefBtn; 

HKEY hOpenKey - 0; 

DWORD BufSize, dwType; 

DWORD *Buffer; 

int loop, loop2, temp; 

if (RegOpenKeyEx(hKey. SubKey. 0. 

KEY_ALL_ACCESS, &h0penKey) !- ERR0R_SUCCESS) 
return; /* key doesn't exist */ 

/* fill in DefBtn, which is the default button to use if* 

* the cmd. ID isn't found in the master TBBUTTON list */ 
memset(&DefBtn. 0, sizeof(DefBtn)); 

DefBtn.fsState - TBSTATE.ENABLED: 

DefBtn.fsStyle - TBSTYLE_SEP; 

/♦call RegQueryValueEx once to get size of stored value*/ 

if ((RegQueryValueEx(hOpenKey. ValueName, 0. 0, 0, 

&BufSize) — ERROR.SUCCESS) && (BufSize !- 0)) 

{ 

/* 0k, the entry exists. Allocate buffer * 

* for the entry, then read it into the buffer */ 

Buffer - (DWORD*)mal1oc(BufSi ze); 

RegQueryValueEx(hOpenKey, ValueName, 0, &dwType, 

(BYTE*)Buffer. SBufSize); 

/* Clear off the current contents of the toolbar... */ 
temp - SendMessage(hTB. TB.BUTT0NC0UNT. 0. 0); 
for (loop - 0; loop < temp; loop++) 

SendMessage(hTB, TB.DELETEBUTTON, 0. 0); 

/* ... and add the new buttons. */ 
for (loop - 0; loop < (BufSize / sizeof(DWORD)); loop++) 
{ 

/* Set Btn to DefBtn, in case the * 

* requested button doesn't exist */ 

Btn - DefBtn; 

for (loop2 - 0; loop2 < nList; loop2++) 
if ((List[loop2].idCommand) — Buffer[loop]) 

{ 


Btn - Btns[loop2]; 
break; 

} 

SendMessage(hTB, TB.ADDBUTTONS, 1, (LPARAM)&Btn); 

} 


/* Deallocate the buffer */ 
free((void*)Buffer); 

} 

RegCloseKey(hOpenKey); 
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the end, a simpler solution) is to use TB_SAVERESTORE to save the 
toolbar, but use a custom routine to restore the toolbar. Figure 4 
shows a generic restoration function. 

The Sample Program 

tbdemo. c (Listing 1) contains a sample program I have com¬ 
piled and tested under Borland C++ v5.x and Watcom C/C++ 
vl0.6. This program is fairly simple (it doesn't even have a 
menu), but it demonstrates most of the topics covered in this 
article. To save space, the sample uses some of the built-in pic¬ 
tures instead of creating its own. A much more in-depth sam¬ 
ple program is available on this magazine's code disk (see 
Table of Contents for availability). 

More Documentation Corrections 

Following are some additional documentation corrections 
for the toolbar control. These are all from the Win32 online 
help that came with the January 1996 SDK and also appear in 
the online help that ships with Borland C/C++ v5. 

The TBN_BEGI NDRAG and TBN_ENDDRAG messages' help pages 
are very misleading; after reading them, the obvious conclu¬ 
sion is that the messages are sent in response to a user's shift- 
click. Actually, the purpose of these messages is to notify the 
toolbar's parent about a drag operation that is not being han¬ 
dled by the control itself. Thus, shift-clicks do not generate 
these messages unless the control doesn't have the 
CCS_AD JUST ABLE style. Also worth noting is that these messages 
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are sent in response to a click even if no Shift, Alt, or Ctrl key 
is being pressed. 

The help text for TBN_BEGI NADJUST and TBN_ENDADJUST mes¬ 
sages do not mention that these are only sent when the 
"Customize Toolbar" dialog is created, and not when the user 
shift-drags buttons. 

The text describing the TBSTY LE_ALTDRAG style does not 
explain that using this style disables shift-dragging. □ 


Listing 1 tbdemo.c — A toolbar demonstra¬ 
tion program 


#define STRICT 
#include <windows.h> 

#1nclude <string.h> 

//include Kcommctrl ,h> 

/***************************************** 
Toolbar Demo Program by Eric Heimburg 
Abbreviations used in the code: 

TB - toolbar CB - combo box 

***************************************** I 


I* global variables */ 
HINSTANCE hlnstance; 

HWND hMainWnd, hTB, hCB: 
LONG OldProc - 0; 


/* toolbar definitions 
//define CBWIDTH 
//define CBEXTRAHEIGHT 
//define ID_TB 
#define ID_CB 
//define IDX_CB 
Idefine NUMBTNS 


*/ 

150 

200 

10 

110 

1 /‘index of CB in Btns array*/ 
(sizeof(Btns) / sizeof(TBBUTTON)) 


/* The master TBBUTTON list */ 

TBBUTTON Btns[] - 

( 

{ STDJOPY, 100, TB$TATE_ENABLED, TB$TYLE_CHECK,'"\0,0}, 

! CBWIDTH, ID_CB, TBSTATEJNABLED, TBSTYLE_SEP."",0,1}, 

{ STOJUT, 101, TBSTATEJNABLED, TBSTYLE_BUTT0N,"",0,2), 
f STDJASTE, 102, TBSTATEJNABLED, TBSTYLE_BUTTON,”",0,3}, 
{ STD_DELETE, 103, TBSTATEJNABLED,TBSTYLE.BUTTON,"",0,4}, 


I* Labels of each entry in the master TBBUTTON list */ 
LPCSTR BtnLabels[NUMBTNS] - 
{ "Copy", "ComboBox", "Cut", "Paste”, "Delete" }; 

/* function to position combobox over toolbar */ 
void FixCBPos(void) 

( 

RECT r; 

int n - SendMessageChTB. TBJOMMANDTOINDEX, IDJB, 0); 
if (n - -1) 

ShowWindowChCB, SWJIDE); 
else { 

SendMessagelhTB, TBJETITEHRECT, n, (LPARAM)Sr); 

SetWindowPosChCB, NULL, r.left, r.top, 

r.right - r.left, r.bottom - r.top + CBEXTRAHEIGHT, 
SWPJOZORDER | SWPJHOWWINDOW); 

} 


/* WNDPROC to subclass "Customize Toolbar" Dialog */ 

LRESULT CALLBACK CustomizeProcCHWND hwnd, UINT Msg, 

WPARAM WParam, LPARAH LParam) 

{ 

DWORD result; 

DRAWITEMSTRUCT ‘pDraw; 

if (Msg -- WMJRAWITEM) { 
pDraw - (DRAWITEMSTRUCT*)LParam; 
if (pDraw->itemData — MAKELPARAMCOxFFFF, IDXJB)) { 
SendMessage(pDraw->hwndItem, LBJETITEMDATA, 

pDraw->itemlD, MAKELPARAMfSTDJROPERTIES, IDXJB)); 
InvalidateRect(pDraw->hwndItem, NULL, FALSE); 

} 
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Listing 1 tbdemo.c — continued 


) 

result - Cal 1 WindowProcf(WNDPROOOIdProc, hwnd, 
Msg, MParam, LParam); 
if (Msg — KMJESTROY) ( 

SetWindowLong(hwnd, GWL_WNDPROC, OldProc); 
OldProc - NULL; 

} 

return result; 


/* function to process notifications coming from hTB. */ 
LRESULT DoToolbarNotify(NMHDR* pHdr) 

{ 

static char buf[128]; 

HWND htemp; 

UINT dwtemp; 

TBNOTIFY ‘pTBHdr - (TBNOTIFY*)pHdr; 

if ((pHdr->hwndFrom—hTB) || (pHdr->code—TTN_NEEDTEXT)) ( 
switch (pHdr->code) { 
case TBNJUERYDELETE: 
if (OldProc — NULL) { 

htemp - FindWindow("#32770", "Customize Toolbar"); 
if (htemp) 

OldProc - SetWindowLong(htemp, GHLJNDPROC, 
(LONG)CustomizeProc); 

} 

return TRUE; 
case TBN_QUERYINSERT; 

return TRUE; 
case TBN_GETBUTTONINFO: 
if (pTBHdr->iItem < NUMBTNS) { 
pTBHdr-StbButton - Btns[pTBHdr->1Item]; 
dwtemp - SendMessage(pHdr->hwndFrom, TB_GETSTATE, 
Btns[pTBHdr->iItem].idCommand. 0); 
if (dwtemp !- -1) 

pTBHdr->tbButton.fsState - (BYTE)dwtemp; 
if (pTBHdr->pszText - NULL) { 
pTBHdr->pszText - buf; 
pTBHdr->cchText - sizeof(buf); 

} 

strcpy(pTBHdr->pszText, BtnLabels[pTBHdr->iItem]); 
return TRUE; 

) 

else 

return FALSE; 
case TBN_TOOLBARCHANGE: 

FixCBPosO; 

break; 


} 

return 0; 


/* main window procedure */ 

LRESULT CALLBACK _export MainWndProc( HWND hwnd, UINT Msg, 
WPARAM WParam, LPARAM LParam ) 

{ 

switch (Msg) 

{ 

case WM_CREATE: 
hTB - CreateToolbarEx(hwnd, 

WSJISIBLE I WS_CHILD | CCS.ADOUSTABLE, ID_TB, 0, 
HINST.COMMCTRL, IDB_STD_LARGE_COLOR, Btns, NUMBTNS, 
0, 0, 0, 0, sizeof(TBBUTTON)); 
hCB - CreateWindowC'COMBOBOX", "ComboBox", 

WS_CHIL0 I WSJ/SCROLL | WSJORDER | CBSJROPDOWN, 

0, 0, 0, 0, hwnd, (HMENU)ID_CB, hlnstance, NULL); 
SendMessagethCB, CB.DIR, 0, (LPARAM)"*.*"); 
SetParent(hCB, hTB); 

FixCBPosO; 

break; 

case WM_DESTROY: 

PostQuitMessage( 0 ); 
break; 

case WM.SIZE; 

SendMessage(hTB, WM.SIZE, 0, 0); 
break; 

case WMJOTIFY: 

return DoToolbarNotifyf(NMHDR*)LParam); 
default: 

return DefWindowProc( hwnd, Msg, WParam, LParam ): 

) 

return 0; 


1 


i/pragma argsused 

int PASCAL WinMainf HINSTANCE hlnst, HINSTANCE hPrevInst, 
LPSTR CmdLine, int nCmdShow ) 

( 

WNDCLASS wndclass; 

MSG msg; 


hlnstance - hlnst; 
if (!hPrevInst) ( 
wndclass. style 
wndclass.lpfnWndProc 
wndclass.cbClsExtra 
wndclass.cbWndExtra 
wndclass.hlnstance 
wndclass.hlcon 
wndclass.hCursor 
wndclass.hbrBackground 
wndclass.IpszMenuName 
wndclass.1pszCl assName 
if ( !RegisterClasst Swndclass ) 
return 0; 


CS_HREDRAW | CSJREDRAW; 
MainWndProc; 

0 ; 

0 ; 

hlnstance; 

Loadlconl NULL, IDIJINL0G0 ); 
LoadCursorC NULL, IDC_ARR0W ); 
(HBRUSH) (C0L0R_WIND0W + 1); 
NULL; 

"TBDEMO"; 

) 


} 

hMainWnd - CreateWindowEx( 0, "TBOEMO", "Toolbar Demo", 
WS_OVERLAPPEDWINDOW. CW_USEDEFAULT. 0, CW_USEDEFAULT. 
0, NULL, NULL, hlnstance, NULL ); 

ShowWindow(hMainWnd, nCmdShow); 

UpdateWindow(hMainWnd); 
while! GetMessage( Jmsg, NULL, 0, 0 ) ) ( 
TranslateMessaget &msg ); 

OispatchMessaget &msg ); 

} 

return msg.wParam; 

} 

/* End of File */ 
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Can't find that bug from a past issue? The Windows 
Developer's Journal CD-ROM with full search capabilities is 
now available. See page 38 for more information. 



Bug++ of the Month 

Mark Nelson 


If you discover a bug in the latest version of your favorite compiler, 
email it to us at wdletter@mfi.com. Please specify which version of 
your compiler you are using and include a tiny program that 
demonstrates the problem, along with the exact command-line 
options needed to compile it. 

A critical element in C++ is the ability to control the cre¬ 
ation and destruction of objects. C++ handles this using spe¬ 
cial functions known as constructors and destructors. A class 
constructor is guaranteed to get called whenever an instance 
of that class is created, and gives you a chance to perform ini¬ 
tialization, allocate resources, etc. A class destructor is guaran¬ 
teed to get called whenever an instance of that class is 
destroyed, giving you a chance to perform cleanup, free up 
allocated resources, and so on. 

When creating objects dynamically, the compiler has to do 
a little bit of work behind the scenes. For example, I can create 
a new object of type Foo using a call such as this: 

Foo *p - new Foo: 

In this case, the compiler (conceptually, at least) generates a 
call to operator new, which allocates enough memory to hold 
the object. The generated code then passes a pointer to that 
memory to the Foo constructor, which then builds an object in 
the newly allocated location. 

Things get even more complicated when I have to create an 
array of objects: 

Foo *pa - new Foo[ 10 ]; 

In this case, the compiler must call operator new to allocate 
enough memory hold 10 objects of type Foo. The really tricky 
part starts when the compiler has to call the Foo constructor 
ten times, passing a pointer to each of the ten slots in the array 
in turn. This was an area where a previous version of the 


Visual C++ compiler exhibited a bug, as explained in the 
December 1995 installment of this column. 

Array Destruction 

The compiler can easily destroy a single object. A call such as 
delete p; 

generates code that passes p to the class destructor, followed 
by a call to operator del ete to free up the memory. To destroy 
an array of objects, I must first change the call to del ete to use 
the array syntax: 

delete!] p; 

That's easy enough for me to do. But what must the compiler 
do in this case? 

The compiler performs some secret bookkeeping in order 
to make the array form of the destructor call work properly. 
This is because it must call the individual destructors for each 
of the elements in the array, one at a time, before calling oper¬ 
ator delete to free up all the memory for the array. Since the 
compiler may not know how many objects are in the array, 
modem C++ compilers stash away the size of the array along 
with the pointer so that they will know how many destructor 
calls to generate when deleting the entire array. 

The VC++ v4.1 Bug 

Today's C++ compilers all handle array creation and dele¬ 
tion smoothly, and Microsoft's Visual C++ v4.1 is no exception. 
However, there is one special case where Visual C++ gets a lit¬ 
tle confused. nov96 . cpp (Listing 1) shows a simple program 
that creates and then destroys a couple of arrays of a derived 
class foo. In this case, there is something a little odd about the 
creation of the second array: it contains 0 objects! Although 
odd, it is legal C++. 


Mark Nelson is a programmer for Addisoft Consulting, Inc. in Dallas, Texas. Mark is the author of The C++ Programmer's Guide to 
the Standard Template Library , from IDG Books, as well as The Data Compression Book, from M&T Books. You can reach Mark 
on the Web at http://web2.airmail.net/markn. 
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Unfortunately, Visual C++ runs into trouble with this con¬ 
struct. When the program calls the delete operator, the illegal 
operation dialog box quickly pops up as the program crashes. 
Figure 1 shows that the program successfully created and 
destroyed the first array. Stepping through the debugger veri¬ 


fies that the problem actually occurs in the destruction of the 
zero length array. 

Microsoft Explains 

Steve Ross from Microsoft was quick to acknowledge the 
problem and explain what was happening. In this case, the 


Listing 1 nov96.cpp — The zero-size array destruction bug 

// 

cout « "in ctor for derived class foo\n" 

// N0V96.CPP 

« flush; 

// 

} 

// This program demonstrates a problem with the Visual C++ 

// 4.x compiler. When attempting to destroy a 0 length 

); 

// array via a virtual function, a GPF occurs. This 

void delete foo( foo *p ) 

// seems to be due to the fact that the compiler generates 

t 

// code to find the virtual destructor via the vtable of 

delete[ ] p; 

// the first element. Since there is no first element, 

// this causes a fault. 

} 

a 

mainO 

^include <iostream.h> 

{ 

int i - 3; 

class base 

cout « "\nCreating foot 3 ]\n\n"; 

{ 

foo *p - new foo[ i ]; 

public : 

cout « "\nOestroying foot 3 ]\n\n"; 

i nt m_i; 

virtual -based { 

delete_foo( p ); 

cout « "in dtor for base class\n" 

i - 0; 

« flush; 

cout « "\nCreating foo[ 0 ]\n\n"; 

i 

p - new foot i ]; 

}; 

class foo : public base 

cout « ”\nOestroying foot 0 ]\n\n”; 
delete_foo( p ); 

{ 

return 1; 

public : 

j 

foo( int i - 5 ) { 
m_i - i ; 

//EOF 


Windows 
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destructor for class foo is virtual, which means that the 
compiler must get a pointer to the destructor from an object's 
virtual function table. Normally, the compiler gets the virtual 
function pointer from element 0 in the array. Unfortunately, 
this array doesn't have an element 0! Attempting to access its 
virtual function table results in a protection violation. 

In this case, Microsoft went above and beyond the call of 
duty. The development staff pointed out that my original test 
program was dependent on undefined compiler behavior, 
which meant that it probably wouldn't be considered a bug. 
The unnamed developer pointed out the changes I needed to 
make in order to make this a true bug! 

Best of all, not only was Microsoft responsive about both the 
bug and the reasons for it, they promised that it would be fixed 


Figure 1 
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in an upcoming release of Visual C++. VC++ 4.2 has already 
shipped, so I would look for the fix in the next release. 

You can add your name to the WD] walk of fame if we use 
your bug in this column. Just send your submissions to 
wdletter@mfi.com. If your letter floats to the top in any given 
month, you will be the proud recipient of a WDJ t-shirt and 
our hearty thanks! □ 


J SDK Annotation #146 

TYPE: Win32 

TOPIC: TVN_ENDLABELEDIT 
KEYWORD: TVN_ENDLABELEDIT 

When editing labels in a TreeView control which 
is part of a dialog, this notification is sent only if 
the user ends label editing using the mouse (by 
clicking outside the edit control). Using the 
Enter and Return keys do not work because 
the edit control does not handle the 
WM_GETDLGCODE correctly, and therefore 
IsDialogMessage processes these keys. 

In order to make the TreeView control accept 
the changes when the user presses Enter, and 
reject the changes on Escape, do the following: 

1. In the TVN_BEGINLABELEDIT notification, 
get the edit contol handle using 
TVMJ3ETEDITCONTROL. Subclass the edit 
control. 

2. In the subclassed procedure, handle the 
WM_GETDLGCODE message and return 
WM_WANTALLKEYS. 

3. Handle the WM_CHAR message. When 
wParam is VK_ESCAPE, send a 
TVM_ENDLABELEDITNOW message to the 
edit control with fCancel = TRUE. When 
wParam isVK_RETURN, send 
TVM_ENDLABELEDITNOW with fCancel = 
FALSE. All other WM_CHAR messages should 
be passed to the default edit control procedure. 

4. In theTVN_ENDLABELEDIT notification, 
remove the subclassing. 

Reference: MSDN article PSS Q130691 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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Understanding NT 


Questions on Services 

Paula Tomlinson 


Although the NT SDK documents the basics of writing NT 
services, programmers often non into issues that the docu¬ 
mentation does not clarify. In this column, I will answer read¬ 
er questions about three such topics: how to pass parameters 
to your service, how logging off affects a service, and why you 
need to know what the SeLoadDri verPri v i 1 ege privilege is. 

Passing Parameters to Services 

I have been reading your articles about NT services in Windows 
Developer's Journal and they have been a big help. I do have one 
question for you that I have not seen an answer to yet. If you use the 
control panel Services applet, you have the option of passing com¬ 
mand-line parameters to the service being started. I have also seen 
users on Usenet and CompuServe mention that you can create a 
"Parameters" key under the registry entry for the service. It is 
implied that the values under this key will automatically be passed to 
the service on its command line as it is started. Is this true? If not, 
how can you pass parameters into a service that is started automati¬ 
cally by the service control manager? 

Thanks for your help. 

Marc H. 

That's a very good question and an often misunderstood 
topic. First, consider the methods for passing parameters to 
manually started services (services marked as 
SERVICE_DEMAND_START when they are created). There are two 
basic ways to start a manual-start service: a user can start a 
service by using the Services control panel applet or the net 
start command, or a program can start a service by calling the 
API function StartService(). 

You can pass parameters to a manual-start service either 
via the call to StartService( ) (if the service is started pro¬ 
grammatically) or via the "Startup Parameters" edit control in 
the Services control panel applet. In either case, these parame¬ 
ters go to the service controller (the internal components of 


NT that manage services), which passes them on to the 
desired service. The slightly confusing part is that the service 
controller does not pass these parameters to your program's 
main entrypoint (mai n() or Wi nMain()), but rather, to your ser¬ 
vice's Servi ceMain() routine. For reference, here are the proto¬ 
types for both StartServi ce() and Servi ceMai n (): 

BOOL StartService( 

SC_HANDLE schService, 

DWORD dwNumServiceArgs, 

LPCTSTR ‘IpszServiceArgs); 

VOID ServiceMain( 

DWORD dwArgc, 

LPTSTR *1pszArgv); 

Because each service has a Servi ceMai n() and is started 
separately you can still pass different parameters to each ser¬ 
vice within the process, even if your service process supports 
multiple services. As usual, the name of the service is the first 
argument in the 1 pszArgv argument list passed to 
Servi ceMai n(). 

This raises the issue of how to pass parameters to auto-start 
services (services that start when the operating system is load¬ 
ing). In this case, the service controller automatically starts the 
service for you, so you have no way of passing parameters to 
the service via the Services applet or via StartService() (the 
service controller is effectively calling StartServi ce() for you 
automatically). To solve this problem, most auto-start services 
(as Marc mentioned) do store startup parameters in the reg¬ 
istry. Where this data is stored in the registry and what format 
it takes is completely up to the service writer. There are some 
general conventions you should keep in mind, though. 

The service controller maintains a database of informa¬ 
tion on each installed service (in this case, "service" can 
refer to a Win32 service application or a Windows NT ker¬ 
nel-mode device driver) in the registry. The information for 
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each service resides under a unique subkey under the fol¬ 
lowing registry key: 

HKEY_LOCAL_MACHINE 

\SYSTEM 

\CurrentControlSet 

\Services 

The service controller uses each service-specific subkey to 
store its own information about each service. By convention, 
services store their own private data under a "Parameters" 
subkey immediately underneath the service-specific key. If 
initialization information is required, the service is responsi¬ 
ble for creating the "Parameters" subkey and for storing and 
retrieving information from that key. Data stored under the 
"Parameters" subkey is not automatically passed to the ser¬ 
vice as command-line parameters. 


Key Facts 

Passing Startup Information 

❖ You can pass startup information to your service via the 
string that is the final argument of StartService(). The 
string will be passed to your Servi ceMai n ( ) routine. 

❖ Using the control panel Services applet, you can specify 
startup information in the "Startup Parameters" edit box 
(which the applet then passes to StartServi ce()). 

❖ If your service starts up automatically at boot time, you 
can store startup information in the registry. By conven¬ 
tion, such data should reside under the following reg¬ 
istry key: 

HKEY_LOCAL_MACHINE 

\SYSTEM 

\CurrentControlSet 

\Services 

\<ServiceName> 

VParameters 

❖ Alternatively, you can pass command-line parameters to 
your process by appending them to the path you pass to 
CreateServiceO. This technique makes sense only for 
single-service processes. 

Services versus Logoff 

❖ Windows 95 "sendees" bear little relation to NT services. 

❖ Your NT service is not automatically notified when a 
user logs on or logs off, nor does NT terminate your ser¬ 
vice just because a user logs off. 

❖ Your service can call SetConsoleCtrlHandler! ) to receive 
notifications when a user logs off. 

❖ Your service can detect user logons by monitoring the 
event log with NotifyEventChangeLogt ) and looking for 
event ID 528. Logon/logoff auditing must be enabled. 

SeLoaderDriverPrivilege 

❖ If the account you're logged in under does not have 
SeLoaderDriverPrivilege, you will get an error when 
you try to start or stop a service. □ 


HKEY_LOCAL_MACHINE 

\SYSTEM 

\CurrentControlSet 

\Services 

\<ServiceName> 

\Parameters 

The information that Marc read about on CompuServe 
may have referred to NT kernel-mode device drivers rather 
than NT services. Even though both NT drivers and NT ser¬ 
vices are often installed and managed by a common set of ser¬ 
vice controller routines, there are some important differences 
in how services and drivers are started. If you start an NT 
device driver by calling StartServi ce(), any parameters that 
you pass will be ignored. Likewise, the Devices control panel 
applet (which is used to manually start Windows NT kernel- 
mode device drivers) does not allow specifying startup para¬ 
meters for a driver. Although it is still completely up to the 
driver writer, Microsoft strongly encourages device driver 
authors to store their own private data under a "Parameters" 
subkey of the driver-specific service key. Again, the format of 
that data in the registry is completely driver-specific. 

Even though most services maintain their own private 
information under the "Parameters" key, there is still a way 
to pass command-line parameters to an auto-start service. In 
the call to CreateService(), you can append extra parameters 
after the fully qualified service executable name in the 
1 pBi naryPathName parameter. These parameters get passed to 
the process's main entrypoint (mai n() or Wi nMai n()), not to the 
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service-specific entrypoint (Servi ceMai n( )). The string passed 
in the 1 pBi na ryPathName parameter is saved in the "ImagePath" 
registry value under the service-specific registry key when the 
service is created. An experienced user could use the registry 
editor to directly modify that registry value. For example, I 
could pass the parameters "x", "y", and "z" to my service's 
mainO entrypoint by making the following changes to the 
ImagePath registry value. 

ImagePath:REG_EXPAND_SZ: 
c:\winnt\system32\wdjsrvc.exe x y z 

This method makes sense only for single-service processes 
(services defined as SERVICE_WIN32_0WN_PR0CESS), because it 
provides a single set of parameters to your mainO or 
WinMainO. For a multi-service process, you would probably 
want to be able to specify a separate set of parameters for each 
service residing in the process. 

Also, you may run into a subtle problem if you use this 
technique with a multi-process service. If you were to register 
more than one service with the same executable but with dis¬ 
tinct command-line parameters, what should happen? If you 
start one of the services, NT will start your process and pass it 
the desired command-line parameters. So far, so good. But if 
you then start one of the other services residing in that 
process, NT will not just create a new thread for that service as 
it usually does. Instead, NT starts up a separate instance of 
your service process. Apparently, it compares the entire 
"ImagePath" string when deciding whether two services 


reside in the same . exe. Since a common motivation for imple¬ 
menting multiple services in a single . exe is to avoid the over¬ 
head of starting new processes, this defeats the purpose. If 
you have a multi-process service, you are better off passing it 
startup parameters via some other technique. 

In general, storing private data in the registry is a much 
more general (and safer) solution than relying on command¬ 
line parameters. The average user should never be expected to 
have to enter data directly into the registry, though, so services 
should have default settings for any required parameters in 
the registry. You might also consider providing a small config¬ 
uration application that writes user settings to the service's 
"Parameters" subkey. 

How Does Logoff Affect a Service? 

I've just read your three articles in Windows Developer's 
Journal (June, July, and August 1996) about NT services. I used the 
code to implement a service of our own. This is a simple service that 
launches one of our GUI applications via CreateProcess (), then 
waits to be stopped via the Service Control Manager or "net stop ...". 
The Service is created under the LocalSystem account and the 
SERVICEJNTERACTIVE_PROCESS and SERVICE_WIN32_0WN_PR0CESS 
flags are used. SERVI CE_AUTO_START starts the service when Windows 
NT starts. I'm having a problem when I log off of Windows, however. 
The service handler gets the SERV I CE_CONTROL_STOP control code, 
and I call Set Event () on the event created, just as in the sample code. 
The service terminates correctly. When I log back in, the Service does¬ 
n't restart. Is this supposed to happen? I thought the service should 
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restart. Or should it not stop on logout? Not stopping on logout 
would be preferable. I found RegisterServiceProcessO in the SDK 
help, and it appears to allow the service to stay running even on 
logout. But the help states RegisterServiceProcessO works only for 
Windows 95. Is this true? Is there a similar function for Windows 
NT? (I scanned the Windows . h files and didn't find this function 
anywhere.) Does my service need to ignore the logout? (The service 
starts a GUI app, which passes the WM_QUERYENDSESSION message to 
DefWi ndowProc ().) Any help would be greatly appreciated. 

Thanks, 

Chris Phinney 


First of all, as Chris suspected, Regi sterServi ceProcess () is 
only available on Windows 95. Although Windows 95 does 
not have a true service controller and does not support the ser¬ 
vice controller API, Windows 95 does offer limited support for 
designating that certain processes be started before logon 
(refer to Knowledge Base article Q125714 for information on 
how to mark such processes in the registry on Windows 95). 
Processes that are so marked are considered the Windows 95 
equivalent of a service. These processes, however, will be ter¬ 
minated when the user logs off unless the process calls 
RegisterServiceProcess(). 


Listing 1 wdjsrvc.c — Detecting user logoff, system shutdown 


II wdjsrvc.c 
#include (windows.h> 

HANDLE hDoneEvent - NULL, hThread - NULL; 

DWORD dwCurrentState; 

SERVICE_STATUS_HANDLE hService; 

BOOL NotifySCMEDWORD, DWORD, DWORD); 

VOID WINAPI ServiceMainIDWORD, LPTSTR *); 

VOID WINAPI ServiceHandler(DWORD); 

BOOL WINAPI CtrlHandler(DWORD dwCtrlType); 

DWORD WINAPI WorkerThreadILPVOID); 

//. 

int APIENTRY WinMainIHINSTANCE hlnst, HINSTANCE hPrev, 
LPSTR lpCmdLine, int nCmdShow) 

{ 

SERVICE_TABLE_ENTRY ServiceTableC] - { 

{TEXT("WDJSrvc"), ServiceMain), {NULL, NULL) 

); 

StartServiceCtrlDispatcher(ServiceTable); 
return TRUE; 


//. 

VOID WINAPI ServiceMainIDWORD dwArgc, LPTSTR *lpszArgv) 

{ 

DWORD Threadld; 

if (ilhService - RegisterServiceCtrlHandlerl 

TEXT!''WDJSrvc''), ServiceHandler))) 

return; 

NotifySCMISERVICE_START_PENDING, 0, 1); 

if (!(hDoneEvent - CreateEventfNULL, FALSE, FALSE, NULL))) 
return; 

if (!(hThread - CreateThread(0,0,WorkerThread,0,0,&ThreadId))) { 
CloseHandle(hDoneEvent); 
return; 

) 

SetConsoleCtrlHandler(CtrlHandler, TRUE); 

NotifySCMtSERVICE_RUNNING, 0, 0); 

WaitForSingleObject(hDoneEvent, INFINITE); 

CloseHandle(hThread); 

CloseHandlet hDoneEvent); 
return; 


//. 

VOID WINAPI ServiceHandlertDWORD fdwControl) 

{ 

TCHAR szObg[MAX_PATH]; 

wsprintf(szDbg, TEXT("WDJSrvc: Service code %d\n"), fdwControl); 
OutputDebugString(szDbg); 


// this service doesn't support pause-continue 
switch(fdwControl) { 

case SERVICE_C0NTR0L_ST0P: 

NotifySCM(SERVICE_STOP_PENDING, 0, 1); 

SetEvent(hDoneEvent); 

NotifySCM(SERVICE_STOPPED, 0, 0); 
break; 

case SERVICE_C0NTR0L_INTERR0GATE; 
NotifySCMIdwCurrentState, 0, 0); 
break; 

default; 

break; 

} 

) 

//. 

BOOL NotifySCMt DWORD State, DWORD ExitCode, DWORD Progress) 

{ 

SERVICE_STATUS ServlceStatus; 

ServiceStatus.dwServiceType - SERVICE_WIN32_0WN_PR0CESS; 
ServiceStatus.dwCurrentState - dwCurrentState - State; 

ServiceStatus.dwControlsAccepted - SERVICE_ACCEPT_STOP | 

SERVICE_ACCEPT_SHUTDOWN; 
ServiceStatus.dwWin32ExitCode - ExitCode; 

ServiceStatus.dwServiceSpecificExitCode - 0; 

ServiceStatus.dwCheckPoint - Progress; 

ServiceStatus.dwWaitHint - 5000; 

return SetServiceStatusIhService, &ServiceStatus); 

} 

//. 

BOOL WINAPI CtrlHandlertDWORD dwCtrlType) 

{ 

if (dwCtrlType — CTRL_L0G0FF_EVENT) { 

OutputDebugString(TEXT!"WDJSrvc: CTRL_L0G0FF_EVENT\n")); 

) else if (dwCtrlType — CTRL_SHUTD0WN_EVENT) { 

OutputDebugString(TEXT("WDJSrvc: CTRL_SHUTD0WN_EVENT\n")); 
) else { 

TCHAR szDbg[MAX_PATH]; 

wsprintf(szDbg, TEXT("WDJSrvc: Ctrl code %d\n”)); 
OutputDebugString(szDbg); 

) 

return FALSE; // pass to next handler 


//. 

DWORD WINAPI WorkerThreadILPVOID ThreadParam) 

( 

while (TRUE) { 

Sleep(lOOOO); 

MessageBeep(O); 

} 

return TRUE; 


I* End of File */ 
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NT, on the other hand, does not automatically stop a service 
just because the user logs off. That statement applies to services 
that run under the LocalSystem account as well as services that 
run under some other user account. In fact, your service must 
do extra work to even be notified of a user logging off at all! In 
other words, your service's handler routine should not be 
receiving a SERVI CE_C0NTR0L_ST0P control code when the user 
logs off. Sendees don't receive SERVICE_C0NTR0L_ST0P codes 
during system shutdown, either. 

Services have to explicitly tell the service controller that 
they want to receive S E RVIC E_C0NTR0 L_SHUTD0W N and 
SERVICE_C0NTR0L_ST0P notifications. A service does this by spec¬ 
ifying the SERVICE_ACCEPT_SHUTDOWN and SERVICE_ACCEPT_STOP 
codes in calls to SetServiceStatus( ). Assuming that a service 
has indicated it wants to receive stop notifications, it will 
receive only the SERV ICE_C0NTR0L_ST0P code when the service 
is explicitly stopped (such as when a program calls 
ControlService(..., SERVICE_C0NTR0L_ST0P ,...), a user types 
"net stop <ServiceName>", or a user stops a service via the 
Services control panel applet). NT does not send your service 
the SERV I CE_C0NTR0L_ST0P code during user logoff or system 
shutdown. NT does, however, send your service a 
SERV I CE_CONTROL_SHUTDOWN notification during system shut¬ 
down. 

What if your service really must be notified when a user 
logs off? For example, an interactive service might need to 
close its window station and desktop handles when the user 
logs off. The Microsoft-recommended (and easiest) way is to 


register a console control handler for the service process. In 
fact, this is how the service controller itself finds out about 
logoff and shutdown events. Console handlers are traditional¬ 
ly used by console processes that wish to be notified of con¬ 
sole events, such as a user typing Ctrl-C in the process's con¬ 
sole. However, all processes — GUI and console — receive the 
CTRL_LOGOFF_EVENT. Likewise, any running services can receive 
both CTRL_L0G0FF_EVENT and CTRL_SHUTDOWN_EVENT events. To 
receive these events, the service process registers a control 
handler function by calling SetConsol eCtrlHandl er(). 

The sample service in Listing 1 (wdjsrvc.c) demonstrates 
receiving control codes via the normal service control handler 
(ServiceHandlerO) as well as via a console control handler 
(Ctrl Handl er( )). Both handler functions call 
OutputDebugStri ng( ) each time they're called. When the sam¬ 
ple service is explicitly stopped, the service controller calls 
Servi ceHandl er( ) with a control code of 
SERV I C E_C0NTR0L_ST0P. When a logoff occurs, the service con¬ 
troller passes no control codes to Servi ceHandlerO, but 
Ctrl Handl er () does get called with the CTRL_LOGOFF_EVENT 
code. When the system is shut down, Ctrl Handl er () receives 
both the CTRL_LOGOFF_EVENT and CTRL_SHUTDOWN_EVENT (since I 
happened to be logged on when I attempted to shut down), 
and Servi ceHandl er( ) receives SERVICE_CONTROL_SHUTDOWN. 

It's important to note that a process can have more than 
one console control handler. If the handler routine returns 
FALSE, then the next handler in the list, if any, will be called. 
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You can also use SetConsoleCtrlHandler! ) to remove a han¬ 
dler function from the list. If a process supports multiple ser¬ 
vices, each service will use the same list of console control 
handlers. All services, whether GUI or console (and whether 
running in the LocalSystem account or some other account) 
receive these events if they have registered a handler. 

Unfortunately, it's not quite as easy to tell when a user has 
logged on. You could potentially enumerate window stations 
and desktops to see if an interactive user has logged on, but 
this would mean that the service must do some sort of polling, 
essentially. Another possibility is to monitor Logon/Logoff 
events in the event log. To be notified whenever an event is 
written to the Windows NT event log, a service can pass an 
event handle to NotifyEventChangeLogt ) and then wait on that 
handle. The event for logon is security event ID 528 and the 
corresponding logoff event is security event ID 538. Note that 
the system must have logon /logoff auditing enabled for these 
events to be logged (you can enable various types of auditing 
using the User Manager program). 

SeLoadDriverPrivilege 

I have my NT service up and running. One small hitch — when 
I try to start it in the control panel as LocalSystem account, NT tells 
me "Access denied" or something similar. When I select another 
account, it runs. What gives? 

Jacques Du Biel 
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Both developers and users often encounter this problem. 
Remember, when you logon to Windows NT, the user account 
that you specify has a set of "user rights" that dictate what the 
user (as well as what any processes that are started during that 
session) can do. In order to start or stop a Win32 service or 
Windows NT kernel-mode driver, the user account must have 
the following advanced user right: SeLoadDri verPri vi 1 ege. The 
Administrator account already has this privilege by default. 
You can add this privilege by running the User Manager appli¬ 
cation. Select "User Rights" under the "Policies" menu and 
then select the "Show Advanced User Rights" checkbox. Note 
that the SeLoadDri verPri vi 1 ege is required to start or stop a ser¬ 
vice when using the Service control panel applet or by pro¬ 
grammatically calling Sta rtServi ce(). 
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Books in Brief 

First Impressions of Recent Titles 


Internetworking with TCP/IP, Volume III, 2nd Edition 
Douglas E. Comer and David L. Stevens 
552 pages (hardcover) 

Prentice Hall, 1996 
$57.00 

ISBN: 0-13-260969-X 

(Editor’s note: this review was provided by Victor R. Volkman.) 
The second edition of Internetworking with TCP/IP, Volume III 
by Comer and Stevens turns the focus to client/server pro¬ 
gramming and applications issue. My first experience with 
this book series was in 1991 with Volume I ("Principles, 
Protocol, and Architecture"), which still remains the most 
readable and concise explanation of TCP/IP I've encountered 
thus far. The authors' approach for Volume III assumes no 
prior client/server programming paradigms and stands com¬ 
pletely on its own as a tutorial. In other words, you can start 
with Volume III and still receive an excellent introduction to 
TCP/IP concepts such as connectionless vs. connection-ori¬ 
ented protocols, services, sockets, and IP addresses. 

Though the book doesn't say "UNIX" anywhere in the title, 
the code and examples assume a UNIX environment. After all, 
UNIX is regarded as the birthplace of TCP/IP and posesses 
the easiest API for its use. Additionally, one of the most popu¬ 
lar client/server configurations in use today is that of 
Windows-based client and UNIX-hosted server. In my opin¬ 
ion, anyone hoping to make sense of Winsock should first 
learn about the original BSD sockets API. Furthermore, the 
authors focus on learning algorithms instead of details and 
spell out as much in Section 6.2: 


Ron Burk 

Although programmers need to understand the conceptual 
capabilities of the protocol interface, they should concentrate on 
learning about the ways to structure communication programs 
instead of memorizing the details of a particular interface. 

Subsequent chapters explore the permutations and details 
of iterative vs. concurrent servers, multiple vs. single process 
servers, stateless vs. stateful, and multiprotocol and multiser¬ 
vice servers (including the inetd daemon). Later chapters 
include external data representation (XDR) and Remote 
Procedure Calls (RPC), a discussion of issues and implemen¬ 
tation of Network File Systems (NFS), and a complete TEL¬ 
NET client. Algorithmically speaking, the emphasis is on uni¬ 
form and efficient management of server concurrency, dead¬ 
locks and starvation issues, and practical hints and techniques 
for UNIX-hosted servers. 

Note that the Internetworking with TCP/IP series appears 
in two separate versions: "BSD Socket Version" (reviewed 
here) and "AT&T TLI Version." This separation avoids having 
to provide twice as many examples or exposing you to an API 
to which you may be indifferent. TLI denotes the Transport 
Layer Interface, an equivalent API which also grew up in the 
mid-1980s. However, with the broad introduction of Windows 
Sockets in 1992, the BSD Socket API has far more non-UNIX 
platform support now than TLI will ever see. Avoid disap¬ 
pointment by checking the ISBN number before you buy the 
book; a $1 difference in list price may also provide a clue. 

The organization of chapters is ideal: each presents a single 
basic technique (such as multiprotocol servers) and backs it 
up with a real working model program, theory of operation, 
and a line-by-line explanation of the new or difficult pieces. 
For the teacher, it also includes relevant exercises for student 
assignments. Such a high level of organization also makes it 


Got an opinion about these or other programming books? Send them to 70302.2566@compuserve.com. You can order any of the books 
that appear in Books in Brief from Miller Freeman, Inc. by calling (913) 841-1631, faxing (913) 841-2624, or sending email to 
orders@mfi.com. If using fax or email, send the book title, author, and publisher along with your MasterCard or Visa number, expiration 
date, and phone number. 

To submit books for review, send them to: Ron Burk, 13846 NE 60th Way, #120, Redmond, WA 98052-4542. Please do not send press releases to 
this address. 
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easy to refer back (or ahead) to and refresh your understand¬ 
ing. Naturally, some chapters cover purely background theo¬ 
ry, but the impetus is to express algorithms in minimal sized 
programs. The two chapters on TELNET near the end provide 
the best explanation of this ubiquitious protocol (including 
working source code) that I've seen yet. 

As is the case with many networking books, the C source 
code is available directly through FTP or indirectly via web 
pages. The authors develop a small library along the way in 
order to encapsulate much of the drudgery of low-level API 
calls and reduce the amount of text required to read each 
example. Examples demonstrate key Internet standard proto¬ 
cols wherever possible (DAYTIME, TIME, ECHO, TELNET, 
NFS), providing cross-platform compatability and allowing 
you to concentrate on one half of the client/server connection 
at a time. A working knowledge of C is sufficient for the read¬ 
er; the most difficult construct is an array of function pointers. 
The authors take pains to explain the use of #1 ncl ude files as 
well as every UNIX API call (e.g. fork() ) presented. The code 
itself is the tightest I've seen anywhere — not an extra line or 
operator anywhere it isn't absolutely required. 

I leave you with the comments of Marshall T. Rose on the 
Internetworking with TCP/IP series: 

Whilst the media and entrepreneurs fill the popular imagina¬ 
tion of "Internet mysticism", it is Dr. Comer who clearly 
explains the technical reality of the technology that makes the 
Internet possible. 
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Network Programming in Windows NT 
Alok K. Sinha 
624 pages 

Addison-Wesley, 1996 
$49.50 

ISBN 0-201-59056-5 

(Editor's note: this review was provided by Victor R. Volkman.) 
Network Programming in Windows NT by Alok K. Sinha is a 
whirlwind tour of the major network API groups in Windows 
NT: RPC, Windows Sockets, Pipes, Mailslots, NetBIOS, and 
IPX/SPX interfaces. Each of these API groups receives 80 to 100 
pages of treatment including example programs. Before getting 
into network API groups, the first 115 pages review various NT 
architecture issues. The architecture discussion is nothing new 
and borrows seven figures from Helen Custer's background 
book. Also, considerable review is given to Win32 concepts 
often required in networked applications: structured excep¬ 
tions, threads, synchronization, and memory-mapped file I/O. 

The RPC chapter deals fairly with the interface issues, com¬ 
plexity, management, and locating services in this environ¬ 
ment. Though RPC has been commercially available for more 
than eight years, it has been slow to garner widespread devel¬ 
oper participation. This chapter reminded me of the addition¬ 
al layer of complexity that RPC necessitates. Also, this chapter 
contains the first instance of the "Echo" server, an example 
program which echoes client messages back. 

The Winsock chapter is the most important given the 
mushrooming popularity of this API in support of Internet 
applications. Sinha provides a dual treatment of sockets over 
both TCP/IP and IPX/SPX protocols. As such, this is the first 
serious treatment of Winsock in the IPX/SPX environment 
that I've seen. This chapter suffers the most from the fast pac¬ 
ing of the book because of the depth required for effective 
treatment of TCP/IP and Winsock. For example, barely half a 
page is devoted to Domain Name Service (DNS) and it 
includes erroneous examples which equate email addresses 
with hostnames (BigServer@BigCorp.Com is not a hostname). 
Advanced topics such as Out-of-Band (OOB) data receive a 
single-page treatment. This book was written too late to 
include coverage for the Windows Sockets 2.0 specification. 
Still, this chapter is a good introduction to Winsock and 
includes many source code examples. 

The chapters on NetBIOS and IPX/SPX provide the same 
depth and type of coverage as earlier chapters. NetBIOS pro¬ 
gramming is actually a bit easier in Win32 than it was in 
Winl6 and these differences are highlighted. Special attention 
is given to large data transfers and asynchronous commands. 
The latter chapter is actually divided equally between IPX and 
SPX into two mini-chapters. 

Source code is available by anonymous FTP instead of 
being included as a code disk. Sinha presents at least one major 
client/server example in each chapter, usually the "Echo" serv¬ 
er. With the pacing required to demonstrate all six API groups, 
this is the most that can be reasonably expected. These exam¬ 
ples are less ambitious than Ralph Davis network-independent 
API layer implementation in Windows Network Programming 
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(ISBN 0-201-58133-7). Still, when reading about Winsock, I 
would prefer to see at least one RFC- based protocol imple¬ 
mentation, even if its only PING or TFTP. The subjects of small¬ 
er examples are somewhat eclectic and hard to relate to real 
world problems (e.g., using Di sneyTour( ) to illustrate RPC). 

Network Programming in Windows NT has a slightly schizo¬ 
phrenic twist — the cover boldly states "Covers Windows for 
Work Groups." Chapter 7 adequately covers Mailslots in 30 
pages and is the only substantive section addressing WFWG 
(other than a brief mention of WNet () API functions). I would 
not recommend this text solely for its WFWG coverage, 
though Winl6 issues are often summarized in each chapter. 

As an aside, there is only passing mention of Windows 95 
throughout the book. Admittedly, I was left wondering 
whether particular APIs had more or less support in Windows 
95 than in Windows NT in several cases. Since I was also 
thrown for a loop by the introduction of Windows 95 while 
preparing a book in August 1995,1 can sympathize with timing 
that might have led to lack of specific Windows 95 coverage. 

Sinha's target audience is experienced C programmers 
with some Windows programming experience and a user- 
level knowledge of networking. This is a reasonable audience 
expectation and his level of writing squarely hits the mark. 

Sinha's Network Programming in Windows NT presents six 
different paradigms for network programming. What's miss¬ 
ing is an analysis to guide you to the most appropriate API 
group. Though Sinha disclaims any use of performance 
benchmarks, and rightly so, there still should be some criteria 
presented (cross-platform compatabilty, 
legacy system compatability, etc.). 

Though each chapter is intended to 
be self-contained (and it does a remark¬ 
ably good job on the Named Pipes, 

RPC, and Mailslots in this respect), 
you'll still need other API-specific 
books to guide you before taking on 
major projects in Winsock, NetBIOS, or 
IPX/SPX (e.g., C Programmer's Guide to 
NetBIOS by Schwaderer). Nevertheless 
Network Programming in Windows NT 
does deliver a broad overview of specif¬ 
ic programming techniques you'll need 
for implementing low-level client/serv¬ 
er applications. 


application, and then they incrementally attempt to introduce 
you to various features by tailoring bits of the generated code 
here and there. While it makes sense to use wizards to gener¬ 
ate an initial MFC application, I feel this is a poor way to teach 
a Windows programmer MFC. The problem is, such books 
always make me feel like I am groping an elephant with a 
blindfold on. The narrative has me bump into various parts of 
some strange beast, but each encounter leaves me feeling 
more blind than before. I need an understanding of the design 
of an application framework, of what's going on inside and 
behind the scenes, in order to have any hope of being able to 
use it effectively. 

This book takes a different approach, and one that works 
much better for me. The first program is a real "Hello world" 
program, but it is real hand-written MFC code, not a wizard¬ 
generated program. Yes, that means typing in the cryptic 
"message map" and other work an experienced MFC pro¬ 
grammer would probably never do by hand. This suffering 
leads to an understanding of the code generated by those 
wonderful wizards, which you need if you ever hope to use 
MFC to its best advantage. Without that understanding, you 
will use the wizard to generate a skeleton, and then you will 
slip back into using vanilla C or C++ to get everything else 
done. If you're going to pay the price of loading in those MFC 
libraries, I think you should make use of them. 

Another road less travelled taken by this book is to build 
somewhat raw Windows applications first, then dialogs, and 
only after all that, tackle the document/view architecture. 
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Again, this works better for me than the more common 
approach of tackling document/view first. This way, by the 
time you start to learn about documents and views, you have 
already learned much about MFC and you have a grasp of 
how it handles windows, message flow, and so on. If you have 
to learn the document/view architecture first, you face a raft 
of new concepts, and it's hard to sort out which are truly 
unique to documents and views and which are simply gener¬ 
al features of the framework. Also, many programmers write 
applications for which the document/view model is simply 
not an appropriate choice (e.g., an application in which the 
main window is just a dialog). 


This book follows a path quite similar to Petzold's updated 
Windows 95 book with some obvious exceptions, such as the 
additional text on the document/view classes. It does not 
attempt to cover OLE, for which I was grateful. It covers the 
common controls, but at a fairly superficial level (you can 
always tell whether someone has really had to exercise the new 
common controls — they invariably have a laundry list of doc¬ 
umentation flaws and bugs they are happy to share). There's a 
chapter on threads that could have been even thinner, as MFC 
has little to do with threads other than to provide a thin object- 
oriented layer over the raw Win32 API. These (the chapters on 
common controls and threads) are not the strong points of the 
book. The book includes a CD-ROM of code, but Microsoft 


Enhance and Analyze 
Images on ANY PC! 


IMAGE 

PROCESSING 


II III! II llli 


Analyzing and Enhancing 
Digital Images 



Dwayne Phillips 


Image Processing in C 

by Dwayne Phillips 

Learn how to manipulate, analyze, and 
process images with CIPS (C Image 
Processing System) on any PC from a 
286 to a Pentium. Phillips has distilled 
image processing to its essentials and 
clearly explains image analysis and 
enhancement techniques. You can 
use CIPS to read and write TIFF 
images; display them on monochrome, 
CGA, VGA, and EGA; and print them 
on a laser printer, graphics printer, or 
character printer. 


Manipulate and Process Images 
with CIPS 

The long-running C/C++ Users Journal senes 
is now a book with updates for the TIFF 6.0 
specification and entirely new chapters on 
Boolean operations and a batch file manager. 
Now you can manipulate images without 
needing a special image processing board, 
math coprocessor, or top of the line display! 



RD 

Technical 

Books 


Use code T60C when ordering 

Image Processing in C 


913-841-1631 
FAX 913-841-2624 


With complete 
System on disk 
Only 

$ 3995 

(plus shipping) 


VISA 





reserves the right to sue you in triplicate 
should you ever use any of the code in 
any program you write. 

This book would be well worth hav¬ 
ing even if some of the weaker chapters 
were eliminated. The book will be well 
appreciated by C++ programmers who 
have learned Windows programming 
from Petzold's book, since much of the 
progression of that book is duplicated 
here — some Petzold examples are even 
reworked in MFC. This book is the best 
introduction to MFC programming that 
I have seen. 


And Keep in Mind 

Delphi, A Developer’s Guide 

Bill Todd and Vince Kellen with Ray Novak and 
Brad Saenz 

M&T Books, 820 pages, $44.95, includes CD, 
ISBN 1-55851-455-4. Reviewed May 1996. 

Sixteen of this book's thirty-three chapters 
focus on database programming: local and 
client/server database applications, BDE, 
data integrity and normalization, security, 
data-aware controls, TQuery and SQL, 
ReportSmith, managing transactions, 
Interbase, and MS SQL-Server. However, it's 
meant to be a general guide for intermediate 
to advanced developers and other topics 
include writing custom components. Object 
Pascal, non-database file handling, excep¬ 
tion handling, and distributing applications. 
Not discussed are OLE, DDE, multimedia 
programming and accessing the Windows 
API. There is no statement about code use in 
the book or on the CD, but none of it is copy¬ 
righted. Overall, the book is good and the 
database coverage is very good. 

The Power of Frameworks for 
Windows and OS/2 Developers 

Taligent, Inc. 

Addison-Wesley Developer's Press, 336 pages, 
$39.95, ISBN 0-201-48348-3. Reviewed June 
1996. 
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The author (Andrew Shebanow) takes a concrete programming 
example, implements it normally, then implements it again as a 
framework to show the difference. This is done separately for 
Windows and OS/2, so you can pick which half of the book matches 
your platform. You can't work through this extended example with¬ 
out grasping the flexibility that frameworks bring to software 
designs. The June review said "If you design C++ classes and you are 
not familiar with the concept of frameworks, I highly recommend 
this book." 

Let's Talk Books 

First, many thanks for your monthly column about book 
reviews. As a consultant, I need a lot of information and find¬ 
ing good computer books seems to be more difficult than ever. 
So, I always read this column with great interest. 

Since MFC books seem to be a hot topic, maybe you'll be 
interested in a few comments and impressions about Jeff 
Prosise's book. Programming Windows 95 with MFC. 

Pros: 

It's certainly the best introduction to the MFC that I have 
read until now -— especially the first part, which is built after 
Petzold's book. Sometimes, I had the feeling I was reading 
Programming Windows again, the only difference being that the 
author used MFC concepts to explain how to write Windows 
programs. The first part of the book makes the basic concepts 
of MFC easy to understand without being obscured by the 
most intricate sides of the doc/view architecture. I like this 
approach very much. Instead of being told to click here and 
there in the IDE, the beginner will quickly have a good under¬ 
standing of what he or she is doing. The programmer is forced 
to manually create message maps and to directly use some 
other fundamental MFC macros instead of letting the wizards 
do the work. Later, when using the wizards, it will be easier to 
understand what these tools actually do and how to modify 
the generated code. 

There's nothing in the book about the VC++ environment. 
All the text is about MFC and Windows programming. No 
cheating, no screen shots from the IDE, only information. 
Again, this forces the reader to write MFC code from the begin¬ 
ning. The VC++ Wizards are not used to create the samples, so 
you can learn how to use MFC less blindly than when using 
these tools. Parts 2 and 3 explain in a simple way how to use 
the doc/view architecture and some more advanced aspects of 
the MFC. Beginners will find these chapters easy to read. 

Cons: 

Seasoned MFC programmers won't find anything new in 
the book or answers to the questions that advanced develop¬ 
ers may have. This is definitely a book for beginners or C pro¬ 
grammers switching from the Windows SDK. 

Mentioning "Win95" in the book title is (once again) mis¬ 
leading. Actually, there's very little about Win95 or even 
Win32 in this book. As the first edition of Blaszczak's book 
was not about Win32, this one is not about Win95. With the 
exception of the chapter about threads and common controls, 
almost everything can apply to Win 3.x (a benefit of MFC pro¬ 
gramming — portabilty from Winl6 is generally good). 

The chapter about Win95 common controls is somewhat 
better than that I have read until now, but certainly not as 
good as the corresponding chapter in Blaszczak's book (I'm 
relying on your comments about this book). It's too short to 


give in-depth information about this topic. 

Well, Scot Wingo's MFC Internals aside, I was inclined to 
consider that the first edition of Blaszczak's book was the best 
MFC book that I had found (although I ordered it because it 
was marketed as a book about Win32 programming — sigh). 
After reading your recent comments about the second edition, 
I will certainly give the gold medal to this one. Back to the 
book store ... 

I also forgot to mention that Prosise's book doesn't discuss 
OLE in any aspect. While I understand this choice for an intro¬ 
ductory book, I think that this is (again) in contradiction with 
the book's title. Win95 programming involves a lot of COM 
and OLE programming. This is the real life. It's now impossi¬ 
ble to interact with the shell without using COM objects, and 
Uniform Data Transfer seems to be the best way to implement 
drag-and-drop and cut-and-paste operations (this is especially 
easy using MFC). So, ignoring this fact is somewhat surprising. 

Best regards. 

Patrick Philippot 

I agree with most of your comments. Programming book titles are 
famous for being nondescriptive of their contents, so I can't disagree 
with you there. However, I absolutely would not want this book to 
cover OLE. OLE is complex enough to deserve its own book, and I 
believe the only way this already-fat book could include OLE would be 
with a superficial treatment that would overlap many other books on 
my shelf that insisted on having a chapter on OLE just to satisfy the 
marketing department. Rather than have the author add a chapter on 
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OLE, I would rather see him spend the time, for example, making the 
chapter on common controls in-depth enough (a strength of 
Blaszczak's book) to cover some of the problems programmers invari¬ 
ably run into when they try to use them in real life. I probably have 
to endure more bad programming books than most programmers, 
and this has led me to cheer anyone who tries to focus their book on 
fewer, not more topics. Thanks for the detailed comments! —rib 


Johnson. Web Developer's Guide to Multimedia and Video. The 
Coriolis Group. 400 pages. $39.99. ISBN 1-883577-96-9. 
Includes CD-ROM. 

Covers a whole lot of ground (writing Java applets, brief 
task descriptions using a zillion different tools, even two 
interviews) in very little depth. Heavily padded with 
screen shots and white space. 


Subject: MFC Internals nutshell review 
FYI, my nutshell book review for you of: 

MFC Internals, by George Shepherd and Scot Wingo, pub¬ 
lisher Addison-Wesley. "Very interesting information! Very 
poorly edited!" 

Frank Brown 
browf@well.com 
http://www.halcyon.com/frog/fhb.htm 

I've picked up that book a few times, enough to determine that it's 
not one of the really bad ones that I can review in an hour. Hopefully 
I will get enough time to tackle it during the coming month. Thanks 
for the concise review! —rib 
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Roberts. Internet Protocols Handbook. The Coriolis Group. 480 
pages. $39.99. ISBN 1-883577-88-8. Includes CD-ROM. 
Reference-style descriptions of common Internet protocols, 
with complete RFCs on the accompanying CD-ROM. 
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Ramirez, Evans, Wingo, Li, Templeman, Fiol, Yuen, Alshibani, 
and Gillet. Visual C++ 4 Masterclass. Wrox Press. 800 pages. 
$49.95. ISBN 1-874416-44-3. Includes CD-ROM. 

The shotgun approach to creating books, with chapters 
covering MFC coding conventions, writing MFC exten¬ 
sions, porting from 16-bit Windows to Win32, COM and 
OLE (assumes you're using MFC), Win95 shell program¬ 
ming, dialogs and property sheets, Windows multimedia, 
DIBs, DirectX, network programming (including WinSock 
and WinINet), and ActiveX. O 


J SDK Annotation #150 

TYPE: MFC 

TOPIC: CStatusBar::SetPaneText 
KEYWORD: CStatusESar::SetPaneText 

Just calling CStatusBar::SetPaneText will not 
display the text in the status bar pane. You need 
to add a Ul update handler for the pane for the 
text to appear correctly. 

In order to set the text for pane index 4, and id 
ID_PANE_FOUR do: 

SetPaneText (4, “Some text”, TRUE): 

and a Ul handler in the message map as follows: 

ON_UPDATE_COMMAND_UI (ID_PANE_FOUR, OnUpdatePane) 

and in the appropriate .cpp file add: 

void CMyClass::OnUpdatePane (CCmdUI *pCmdUI) 

1 

pCmdUOEnable 0; 

1 

Reference: MSDN PSS No. Q109039 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “H&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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TurboPower Updates Orpheus with Database Components 


TurboPower Software Company has updated 
Orpheus, a component collection for Borland Delphi 
1.0 and Delphi 2.0. Orpheus 2.1 now includes new com¬ 
ponents that deliver high-level database capabilities in 
addition to the 50 data entry components that were in 
Orpheus 2.0. Components in Orpheus 2.1 include incre¬ 
mental search fields, sort order selectors, and data- 
aware column lists. Orpheus 2.1 also features a new 
AttachedButton component that can be associated with 
any other component to perform programmer-defined 
actions at runtime, and a CheckListbox that displays a 
scrolling list of checkbox items. The new components 
augment a full collection of components for building 


professional data entry forms. Orpheus components 
include those for fully validated entry of all data types, 
flexible grid controls, listboxes with unlimited capacity, 
and spinner controls. 

Orpheus 2.1 costs $199. Owners of Orpheus 2.0 can 
download a free patch from www.tpower.com, 
CompuServe, or the TurboPower BBS (719-260-9726). 
Customers owning any other TurboPower product may 
purchase Orpheus 2.1 for $159. For more information, 
contact TurboPower Software, Inc., P.O. Box 49009, 
Colorado Springs, CO 80949-9009; 800-333-4160 or 
719-260-9136; fax 719-260-7151; support@tpower.com; 
www.tpower.com. 


Crescent Offers Repository Tool for VB4 

The Crescent Division of Progress Software 
Corporation announced Scope/VB, a repository tool for 
code sharing and centralized access to concurrent Visual 
Basic development projects. Scope/VB gives developers 
the ability to view and categorize multiple existing and 
new VB projects. Additionally, the tool enables develop¬ 
ers to reuse code from standing projects by copying and 
referencing existing code, forms, and objects. Scope/VB 
presents developers with a Windows 95 Explorer-like 


interface. In a team environment with Scope/VB, devel¬ 
opers examine, share, reuse, and manipulate project com¬ 
ponents such as forms, code, objects, and thumbnail 
views of forms. 

Scope/VB costs $99.95. For more information, con¬ 
tact the Crescent Division of Progress Software 
Corporation, 14 Oak Park, Bedford, MA 01730; 
800-352-2742 or 617-280-3000; fax 617-280-4025; 
crescent@progress.com; www.progress.com. 


Crescent Announces The Web Jump Start Kit 


The Web Jump Start Kit helps VB programmers port 
their applications to the next VB platform, the Internet. 
To ease the transition to the Web, Crescent is supplying 
The Web Jump Start Kit to developers free of charge. 

The Web Jump Start Kit includes a Visual Basic 
development tool and documentation. Also included is 
a white paper, discussing factors to consider during the 
migration process. 


The Web Jump Start Kit is available at no charge 
from the Crescent Code Depot online storefront 
(http://crescent.progress.com). For more information, 
contact the Crescent Division of Progress Software 
Corporation, 14 Oak Park, Bedford, MA 01730; 
800-352-2742 or 617-280-3000; fax 617-280-4025; 
crescent@progress.com; wwiv.progress.com. 
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Crescent Ships VB AppFranteivork 

VB AppFramework, a Visual Basic-integrated devel¬ 
opment tool, eliminates routine programming tasks and 
cuts development time by residing directly in the Visual 
Basic environment and consolidating tedious but neces¬ 
sary development steps. Developers can use VB 
AppFramework to lay out a complete custom application 
framework to start a new project, add related collections 
of controls to any form, customize forms and controls 
without accessing the properties window, insert com¬ 
monly used forms into existing projects, and cleanup 
non-conforming visual designs. 

VB AppFramework includes a library of royalty-free. 

Rogue Wave Offers DBTools.h++ 2.0 

Rogue Wave Software has announced DBTools.h++ 
v2.0, an enhanced version of its C++ interface to rela¬ 
tional databases that uses key new features and class 
optimization. New features include binding variables to 
SQL statements, asynchronous database access, and 
thread safety. Version 2.0 safeguards include flexible 
error handling that confirms the validity of a database 
connection before performing an operation. 

DBTools.h++ 2.0 encapsulates SQL 92 DML function¬ 
ality to provide a common C++ programming interface 
to major relational databases. It offers native access to 
Oracle, Sybase, Informix, and Ingres databases, with 

PowerBASIC Ships Upgrade of Its DLL 

PowerBASIC, Inc. has released an upgrade of the 
PowerBASIC DLL Compiler. Version 1.1 introduces 
their new Direct/32 technology. Using Direct/32 tech¬ 
nology, programmers can create a single DLL and call it 
from both 16- and 32-bit code. 

PowerBASIC DLL provides 16-bit functionality in 
32-bit code, such as direct access to hardware ports and 
shared memory, improved performance, an improved 
string engine for faster string handling, and enhanced 


professionally designed forms, functions, and frame¬ 
works. Developers can use the supplied elements as is, 
customize them to meet specific business needs, or 
build upon existing objects to include new styles, tem¬ 
plates and frameworks. 

VB AppFramework costs $249 and can be purchased 
directly from the Crescent Code Depot online store¬ 
front (http://crescent.progress.com). For more infor¬ 
mation, contact the Crescent Division of Progress 
Software Corporation, 14 Oak Park, Bedford, MA 
01730; 800-352-2742 or 617-280-3000; fax 617-280-4025; 
crescent@progress.com; www.progress.com. 


general connectivity through ODBC. Communication 
with the call level interface (CLI) of an underlying data¬ 
base is handled transparently by database-specific 
Access Libraries available from Rogue Wave. 

DBTools.h++ 2.0 prices begin at $1,495 for a single- 
user source code license; site licenses are also available. 
Platforms supported include Win95, WinNT, Sun Solaris, 
Sun OS, HP-UX, Irix, Digital UNIX, AIX, and OS/2. For 
more information, contact Rogue Wave Software, Inc., 
850 S.W. 35th St., Corvallis, OR 97333; 800-487-3217 or 
541-754-3010; fax 541-757-6650, sales@rogiewave.com; 
wzvw.roguewave.com. 

Compiler 

error reporting. It fixes all known problems in the initial 
release. 

The PowerBASIC DLL Compiler vl.l upgrade will 
be sent free to all registered PB/DLL users world¬ 
wide. Others may purchase the product for $149. For 
more information, contact PowerBASIC, Inc., 316 
Mid Valley Center, Carmel, CA 93923; 800-780-7707 or 
408-659-8000; fax 408-659-8008; zvww.powerbase.com. 


Sax Software Announces Basic Engine Pro 3.0 


Sax Software is now shipping the latest version of its 
VBA macro language. Sax Basic Engine Pro. Version 3.0 
brings the Basic Engine's feature set up to that of the 
current version of Microsoft's Visual Basic for 
Applications, and then goes further by adding features 
that VBA doesn't offer, including full support for events, 
classes, and multiple modules. Because it's an ActiveX 
control. Sax Basic Engine Pro can be integrated into 
Visual Basic, Visual C++, and Delphi applications. 

Sax Basic Engine Pro offers full VBA power, syntax 

Altura Ships QuickHelp 4.0 

Altura Software, Inc. has released version 4.0 of its 
QuickHelp Online Help and Documentation System. 
QuickHelp has always been source-level compatible 
with Microsoft WinHelp (the standard help system on 
Windows). 

Now, QuickHelp 4.0 adds support for features found 
in WinHelp 4.0 (the help engine in Windows 95) includ¬ 
ing: one-to-one compatibility with MS WinHelp 4.0 
source, new macros, full CNT file support, on-the-fly 


highlighting, and includes an integrated editor and 
debugger that can call a stack, set a variable watch, or 
single-step through code. 

Sax Basic Engine Pro costs $495, requires no royalties 
or runtime fees, and ships with an unconditional 30-day 
money-back guarantee. For more information, contact 
Sax Software Corporation, 950 Patterson St., Eugene, OR 
97401; 800-645-3729 or 541-344-2235; fax 541-344-2459; 
info@saxsoft.com; www.saxsoft.com. 


keyword index, outline merging, full text interface, Alink 
and KLink support, multiple secondary windows, hyper¬ 
text links, graphics, sound, QuickTime movies, full text 
search indexing, popup definition windows, and sticky 
notes for annotation. 

QuickHelp 4.0 costs $495. For more information, con¬ 
tact Altura Software, Inc., 510 Lighthouse Ave., Suite 5, 
Pacific Grove, CA 93950; 408-655-8005; fax 408-655-9663; 
quickhelp@altura.com; wzvzv.altura.com. 
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Ryan McFarland Releases VanGui Interface Builder for Delphi, Enterprise 
CodeBench 


Ryan McFarland, a division of Liant Software 
Corporation, has released the VanGui Interface Builder 
for Delphi and Enterprise CodeBench. 

The VanGui Interface Builder enables COBOL devel¬ 
opers to use their choice of industry-standard tools, such 
as Borland's Delphi and Microsoft's Visual Basic, to 
develop the Windows client user interface for Windows 
or UNIX-based COBOL applications. The underlying 
technology enables the physical separation of the presen¬ 
tation and application logic layers in a three-tier model. 
As a result of the application partitioning, a variety of 
user interface environments can communicate indepen¬ 
dently or concurrently with the same application for dis¬ 
tributed computing across the enterprise. 

Enterprise CodeBench enables developers to edit. 


compile, and debug RM/COBOL applications at the 
source level, utilizing a sophisticated graphical user 
interface. This new development environment includes 
a "project" feature that significantly improves develop¬ 
er productivity by organizing the complete develop¬ 
ment process. 

Introductory pricing for the VanGui Interface 
Builder for Delphi single-use development system is 
$2,000. Enterprise CodeBench costs $1,695 for a single 
use development. Site license agreements and vol¬ 
ume discounts are available for both products. For 
more information, contact Ryan McFarland, 8911 
North Capital of Texas Highway, Suite 4300, Austin, 
TX 78759-7267; 800-762-6265 or 512-343-1010; fax 
512-343-9487; www.liant.com/rm. 


TurboPower Ships Async Professional 2.0 for Delphi 


TurboPower Software Company has released Async 
Professional 2.0 for Delphi (APD), a collection of com¬ 
ponents for Borland Delphi 1.0 and Delphi 2.0. Async 
Professional for Delphi is used to design full-featured 
serial communications applications. Its native Delphi 
components allow for complete serial port control, ter¬ 
minal emulation, support for a wide range of protocols, 
and debugging tools. 

New features of version 2.0 are 16- and 32-bit com- 


DDC-I Ports DACS-80x86 to WinNT 

DDC-I Ada Compiler Systems (DACS) have ported 
the DACS-80x86 Ada compiler system to the 
PC/Windows NT platform. Windows NT-based DACS 
products offer a Ada environment using the familiar 
Microsoft Windows user interface. It can generate appli¬ 
cations to run native on NT PCs or remotely on embed¬ 
ded 80x86 targets. 

DACS-PC for Windows NT supports distributed 
development of Ada applications and provides project- 
level controls to set tool options as well as to build and 
manage programs. The development systems include a 
Windows-based GUI to all development tools including 
a compiler, linker, symbolic Ada debugger, library man¬ 


pa tibility using Delphi 1.0 or 2.0, fax components, and 
support for TAPI under Microsoft Windows 95. 

Async Professional 2.0 for Delphi costs $199. 
Upgrades from vl.O are $79. Customers owning any 
other TurboPower Software Product can purchase APD 
for $159. For more information, contact TurboPower 
Software Company, P.O. Box 49009, Colorado Springs, 
CO 80949-9009; 800-333-4160 or 719-260-9136; fax 
719-260-7151; support@tpower.com; www.tpower.com. 


ager, program builder, stack size analyzer, disassembler, 
and assembler. Additional options, including an FAA- 
certifiable Ada runtime system (including tasking), sup¬ 
port for a bare PC used as a target, fast Ethernet down¬ 
loading, and remote ICE debugging, are also available 
with Windows NT-hosted DACS-80x86. 

Prices for DACS-PC for Windows NT Native (for 
all 80386-, 80486-, and Pentium-based PCs) begin at 
$3,000. Prices for DACS-80x86 Cross (for Windows 
NT-hosted PCs) begin at $12,000. For more informa¬ 
tion, contact DDC-I, Inc., 400 N. 5th St., Ste. 1150, 
Phoenix, AZ 85004; 602-275-7172; fax 602-252-6054; 
ddciiphx!support@uunet.uu_net; www.ddci.com/. 


Data Dynamics Announces Internet-Enabled ActiveX OLAP Tool 


Data Dynamics, Ltd. has announced an 
Internet/intranet enhancement for its DynamiCube On- 
Line Analytical Processing (OLAP) tool. DynamiCube 
1.3 brings interactive OLAP capabilities to ActiveX- 
enabled pages posted on the Web. Developers can use 
any 32-bit programming environment to add 
DynamiCube 1.3 to their applications. 

Using DynamiCube 1.3, developers can now add the 
ability to store DynamiCube data and layout as 
Microcubes on ActiveX Internet and intranet Web sites. 
These are compressed, persistent representations — data 
that cannot be permanently changed by site visitors — of 


DynamiCube views. This allows companies to select 
production data from any ODBC database and store the 
data for easy retrieval from Web sites, LANs, email, and 
workflow systems. Users don't need a connection to the 
production database to perform analysis. 

DynamiCube costs $499, which includes royalty- 
free distribution with any end-user applications. 
Registered users can download the enhanced version 
for free from www.datadynamics.com. For more infor¬ 
mation, contact Data Dynamics, 2600 Tiller Lane, 
Columbus, OH 43231; 614-895-3142; fax 614-899-2943; 
www.datadynamics.com. 
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Snowbound Software Offers RasterMaster Library v6.0 


After a satisfactory settlement of the litigation with 
AccuSoft Corporation, Snowbound Software can now 
announce Version 6.0 of its RasterMaster Library. It sup¬ 
ports over 40 raster formats including TIFF, JPEG, PCX, 
BMP, GIF, PNG, IOCA, CALS, and PhotoCD. New fea¬ 
tures for Version 6.0 include auto deskewing, despeck- 
ling, automatic aspect ratio correction, PNG reading, 
Internet-ready transparent and interlaced GIF support. 


and support for 386SX and 486SX systems. 

The Raster Master toolkits start at $795 for the 
Silver Edition and $1,595 for the Platinum Edition. 
For more information, contact Snoivbound Software, 
P.O. Box 520, Newton, MA 02159; 617-926-1822; fax 
617-926-1233; simwiz@snowbnd.com; 
iuww.snowbnd.com. 


MultiQuest Releases S-CASE 3.0 for Win95, WinNT 


MultiQuest announced the release of S-CASE 3.0 for 
Windows 95 and Windows NT. This new version sup¬ 
ports the Unified Modeling Language specification, 
proposed by Grady Booch, Ivar Jacobson, and Jim 
Rumbaugh, that represents the unification of the Booch, 
Objectory, and OMT methods. 

S-CASE 3.0 also introduces scripted access to its meta¬ 
model. Users can now extract model elements using Tel 
scripts and output them in whatever format they wish, 
such as C++, Java, Smalltalk, database schemata, data 
dictionaries, or customized reports. The built-in C++ 


code generator is written entirely in Tel, enabling users to 
customize the output to their coding standards. 

S-CASE 3.0 for Windows 95/NT lists at $495 for 
each single-user license and $749 for each floating 
license. A save-limited evaluation version can be 
downloaded from www.multiquest.com or 
ftp://ftp.netcom.com/pub/sh/showcase/demo_win3 
2/scase3.zip. For more information, contact MultiQuest 
Corporation, 1931 N. Mecham Rd., Ste. 318, 
Schaumburg, IL 60173; 847-397-9930; fax 847-397-9931; 
info@midtiquest.com; wivw.multiquest.com. 


Softbridge Ships ATE 4.0 

Softbridge, Inc., has released Automated Test Facility 
(ATF) 4.0. ATF 4.0 tests an application's GUI, multi-user, 
and business processes. Using a two-tier architecture, 
ATF 4.0 provides organizations the ability to test business 
processes performed in an enterprise-wide environment, 
as well as run standalone GUI and multi-user tests. In 
ATF 4.0, tests are orchestrated and executed from a single 
point of control, so the actions of one user will stimulate 
the actions of another in an interdependent fashion. A 
feature of ATF 4.0. is ATF/TestWright, an integrated test 
development, execution, and reporting environment for 
Windows NT and Windows 95 that improves QA effec- 

O'Reilly Offers WebSite Professional 

WebSite Professional runs on both Windows NT and 
95 and includes cryptographic security, support for a 
wide range of programming applications. Open Data 
Base Connectivity (ODBC) integration, three new 
books, and several software development kits. 

WebSite Professional supports the two most widely 
used security protocols for confidential transactions. 
Secure Sockets layer (SSL) version 2.0 and Secure 
Hypertext Transfer Protocol (S-HTTP). Both of these stan¬ 
dards provide cryptographic privacy for such transmis¬ 
sions as credit card purchases on the Web or publishing 


tiveness and productivity. Additionally, the ATF/Testlab 
Command Center, the central point for masterminding 
the overall test, now runs under Windows NT and incor¬ 
porates a new GUI that provides a visual means of creat¬ 
ing and monitoring multi-user tests. 

The base system costs $21,000 and includes the 
Testtab Command Center, two copies of TestWright, and 
two ATF agents. For more information, contact 
Softbridge Inc., 125 CambridgePark Drive, Cambridge, 
MA 02140; 617-576-2257; fax 617-864-7747; 

market@sbridge.com; www.sbridge.com. 


corporate strategies on Intranets. S-HTTP provides per¬ 
sonal digital signatures and authentication. 

WebSite Professional costs $499, which includes a 30- 
day money-back guarantee and 90 days of free online or 
telephone technical support; after 90 days, support is 
offered for a fee. Upgrades for WebSite 1.1 customers 
are $99. For more information, contact O'Reilly & 
Associates, 103 Morris St., Ste. A, Sebastopol, CA 95472; 
800-998-9938 or 707-829-0515; fax 707-829-0104; 
elias@ora.com; http:llsoftivare.ora.coml. 


ObjectSpace Announces Java Generic Library 


ObjectSpace, Inc. announces that the Java Generic 
Library (JGL) is now available for free commercial use. 
The Java Generic Library is a set of 14 reusable contain¬ 
ers and 70 generic algorithms for Java. It is designed 
specifically for performance and use in a distributed 
environment, and is completely compatible with Sun 
Microsystems Java Developer's Kit (JDK). 

The Java Generic Library algorithms can be used inde¬ 
pendently of its containers and can be applied to native 
Java arrays of objects, native Java arrays of primitives, all 
Java Generic Library containers, and java.util.Vectors 


from the existing Java Developer's Kit. This enables the 
Java Generic Library to remain small and efficient, vital 
for distributing applets and applications on the web. 

The standard Java Generic Library release includes 
full source code, online HTML documentation, compre¬ 
hensive examples, a 100-page tutorial, and a suite of 
performance benchmarks. 

For more information, contact ObjectSpace, Inc., 
14881 Quorum Dr., Ste. 400, Dallas, TX 75240; 
214-934-2496; fax 214-663-9100; jgl@objectspace.com; 
www.objectspace.com. 
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Readers' Forum 


Send letters to wdletter@mfi.com. 


Name: Luigi Mario Zuccarelli 
E-mail: luigiz@rotron.co.za 
Topic: Great Magazine 

Just a note to tell you that you have a 
very informative, interesting journal; it's 
really great. Being a consultant pro¬ 
gramming in the Windows environment 
(Win3.1x, Win95, and NT 3.51), it's like 
my lifeline to getting around some 
heavy problems (all the help I can get 
type of thing). Keep up the good work! 

At the end of a long day of bugs, crashes, 
and things gone wrong, it's always nice to 
get a compliment — thanks! —rib 


Subject: Decorated exported names in 
VC++ 4.1 

In your article "Building Win32 
DLLs the Right Way" (WDJ, August 
1996), you discussed the problem of 
VC++ mangling the exported C func¬ 
tion names unless you use a . def file. I 
have found another way to avoid man¬ 
gling exported names without using a 
.def file. My suggestion does not modi¬ 
fy source files, so it should — if I under¬ 
stood your article correctly — work 
with Borland compilers as well, which 
do not mangle names. 

From the Build menu in the 
Microsoft Developer Studio, choose 
Settings, then choose the Link tab with 
the desired project configuration select¬ 
ed. Click in the Project Options box at 
the bottom of the dialog box, then add 
the switch /EXPORT: f uncti onname, where 
functionname is the undecorated name 
of your exported function to the com¬ 
mand-line options. Do this for each 
function you wish to export with an 
unmangled name, and for each project 
configuration where you want the DLL 
compiled with an unmangled name. 
This has the same effect as the 
EXPORTS section of a .def file, and 


without any additional files or changes 
to the source files that could render 
them incompatible with other compil¬ 
ers. Use of the DUMPBIN utility with the 
completed DLL and the /EXPORTS switch 
reveals that the names are unmangled. 
While this may be inconvenient if your 
DLL has many functions, it is more con¬ 
venient for simple DLLs than a . def file, 
which needs to be added using com¬ 
mand-line switches in the linker, since 
there is no option in Developer Studio 
to add a .def file. 

Claudio Friederich 
claudiof@hula.net 

It's nice to know how to set the appropri¬ 
ate option from the IDE, but I surely would¬ 
n't use this technique myself. It's bad enough 
that Microsoft requires double maintenance 
for exported functions (you have to declare 
them special in both the .def and the .c file), 
but when you store the . def half of that infor¬ 
mation in the IDE, it seems to me even more 
likely to get overlooked by future maintainors 
of your source code. Not nice either way, in 
my opinion. Thanks for the tip! —rib 


From: John T Davies 
<John_T_Davies@amvision.com> 
Subject: My request 

After going through my old maga¬ 
zines, I was able to get rid of old Dr. 
Dobbs, Embedded Systems Programming, 
C++ Report, C/C++ Users Journal, and 
Microsoft Systems Journal. Why, you may 
ask. Well, it's because they sold me CDs 
that have the complete text and draw¬ 
ings of their old magazines. Now here's 
what I want you to do: 

1. Contact Microsoft about their 
MDSN infoviewer and see if you can get 
the API for it. That would allow me to 
browse your CD (see step 2) from Visual 
C++ or through the infoviewer that 
Microsoft is going to graciously allow 
you to include on your CD (see step 2). 
If this doesn't work, contact Dr. Dobbs, 
or as the last choice, use Acrobat. 

2. (This is the important one.) Make a 


CD of the back issues of your magazine. 
If any of your authors give you trouble, 
send them to me or put a note on the CD 
where their article would have appeared 
explaining how the pinhead that wrote 
this article wanted to squeeze us for too 
much money and so we didn't include 
their article. Include an email address 
for the author. 

3. Send me a phone number so I can 
order it. (Optional) Consider giving 
long-term subscribers a discount on the 
CD, since they already paid once for the 
information in another form. 

4. (I'll handle this one.) Clean out my 
office and donate the old magazines to a 
local library or toss them if they don't 
want them. 

I know it seems like the bulk of the 
work is yours, but you haven't seen my 
office. 

Thanks, 

John Davies 
Applied Machine Vision 

Your office sounds too much like my 
own. You can buy our CD-ROM for $49.95, 
plus shipping and handling (see page 36 for 
details). 1 did, in fact, contact Microsoft to 
see if they would give us enough informa¬ 
tion to make our CD-ROM viewable by 
their tools. I got no response, though you 
can see this is a popular question since it 
made the MSDN FAQ, where the answer 
says (and I'm paraphrasing here) "go 
away." We did, however, use the same 
underlying search engine (MediaView) as 
the Microsoft product, so if they ever do doc¬ 
ument their little extensions, there's a 
decent chance we could make our product 
viewable by their viewer. 

The upside of this is that since I rolled 
my own software (MediaView doesn't pro¬ 
vide the user interface), I can by gum make 
it work the way I want. I will continue to 
work on and extend the viewer and place 
updates at our Web site, so if you buy the 
CD-ROM and your favorite feature is miss¬ 
ing, there is a real person you can send email 
to who actually might be able to remedy the 
problem. The years covered are December 
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1991 through December 1995, so you can't 
throw away your old Tech Specialists just 
yet. Still, I have to say I have already found 
the ability to do full-text searches of our 
past issues extremely convenient. 1 hope 
you will give the product a try and give me 
your ideas for improving it. —rib 


Subject: WDJ 08/96 Timing Article 
The August 1996 issue of Windows 
Developer's Journal contains the well- 
researched and written article "A More 
Accurate Timing Tool/' which discuss¬ 
es improved techniques to use the PC's 
8253/8254 timer to provide very accu¬ 
rate time measurement capabilities. I 
noted one interesting omission in this 


article published in a Windows pro¬ 
gramming magazine: the techniques 
discussed work under DOS only, and 
do not work correctly under Windows 
3.x, Windows 95, or Windows NT. The 
8253/8254 and the 8259 PIC are all vir¬ 
tualized when running under any of 
the Windows environments, and user 
code simply does not have complete 
access to the required hardware. 
Certainly the published code will exe¬ 
cute under Windows 3.x, but the results 
will not be correct and there is really no 
way to detect that the timings are in 
fact bogus unless they are independent¬ 
ly confirmed using another timing 
method. High-resolution timing is pos¬ 
sible under the Windows platform vari¬ 


ants, but it is done using platform-spe¬ 
cific function calls: an undocumented 
interface to the Windows 3.x timer VxD 
is available via the I NT 2Fh interface, 
and Windows 95 and NT support the 
function QueryPerformanceCounter(). 

The article was well done, but it is 
valid in the context of a pure DOS envi¬ 
ronment only. Publishing this article in 
a "Windows Developer's Journal" 
without an adequate "This works in 
DOS only" disclaimer would seem to 
me to be poor editorial judgement. 

Thomas Leathley, Ryle Design 
Publishers of PC Timer Tools, 
PC Timer Objects, and ExacTicks 
73047.1765@compuserve.com 
(Support) ryle@sojourn.com 
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Complex List Boxes FAST! 


Eliminate tedious trial and error setting 
up complex list boxes, combo boxes, 
and column headings with 

ListBox Designer™ 

Windows 3.lx, 95, NT 

Unique powerful tool for advanced 
programming determines 

• List/combo box width 

• U st/combo box tab stops 

• Column heading sizes and positions 

• Widest data per column 
Language independent. 

Supports most popular fonts. 

$129 
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CDROMs! 


Official Slackware™ Linux - Slackware 3.0 (ELF) Linux, by author of 
Slackware. Easy install: leam Unix. XFree86 3.1.2, Td/Tk, GCC 
(2.7.0) compiler, Doom™. Works on 98% of PC's. 2 discs. $39.95 
Slackware subscription - convenient 3 month updates. $24.95 
FreeBSD* 2.1 - Berkeley BSD for PC. Solid Unix®4ike, src, XFree86 
3.1.1, dev. tools, etc. (Subscription every 6 mo. $24.95) $39.95 
CUG Library - 10 years C/C++ Users' Journal src, listings. $49.95 
CICA® MS Windows - 5000 up-to-date shareware. 2 CDs. $29.95’ 
Hobbes OS/2 Archived - 1000MB OS/2 apps, drivers. $29.95’ 
Blackhawk 95 - 200 MB great Windows 95 applications. $29.95’ 
Newt for NT - Windows NT app's, src, utils, GNU, drivers. $39.95’ 
Simtel® MSD0S - Two disc set classic MSDOS shareware. $29.95’ 
Science Library - Technical, engineering shareware + book. $39.95’ 
Perl - Source, binaries for many systems, documents. $39.95 
Math Solutions - Math programs, source code, docs. $39.95’ 
POV-Ray - 3-D Raytraring: 1000 wow! images, src/binaries. $39.95 

'Shareware programs require separate payment to authors if found useful 

— Authors wanted. Please email discdev@cdrom.com — 


ORDER NOW! 1-800-786-9907 


Shipping is $5 in USA/Canada/Mexico, $9 Overseas per order 



Walnut Creek CDROM 

* Suite D-693, 4041 Pike Lane, Concord CA 94520 
Phone: +1-5105740783 • FAX: +1-5105740821 • email:orders@cdrom.com 
All of our CDROMs are 100% unconditionally guaranteed! 

Call today for your free catalog of all our CDROM titles! i- 1 

See these products free at http://www.cdrom.com/ Adcode: 693 
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Looking For Something? 


WinGREP can find it 

WinGREP is a multi-file search 
utility that can quickly locate text 
strings in source code files. 
Tight integration into over a 
dozen editors and integrated 
development environments 
(IDE's) sets WinGREP apart 
from other search utilities. 
WinGREP can be customized to 
automatically synchronize an 
editor or IDE with the results of a 
search. Not only does it open 
the file, but it will also position to 
the line of the match. The ability 
to display the results of a search 
in a programmer’s native work¬ 
ing environment makes main¬ 
taining volumes of source code 
a manageable task. 


✓ Optimized for programmers 

✓ Very fast search performance 
o' Save, load, and print results 

✓ Easy regular expressions 

✓ Long file names 

✓ UNIX text file support 

✓ Quantity pricing available 



Trial Version Available 

$39 + 4SH(US) 
Toll Free 24hrs (US) 

( 888 ) 946-4737 


Hurricane Software, Inc. 

www.hurricanesoft.com • CompuServe go WINUTIL 
e-mail mail@hurricanesoft.com • CompuServe 102470,2564 
2401 SE 7th • Blue Springs • MO 64014 • (816) 373-9252 


a Request Reader Service #164 o 



Call 800-645-3729 now for your 
free catalog about Sax Comm 
Objects, Sax Setup Wizard, Sax 
Webster Control, and Sax Basic 
Engine. 


http://www.saxsoft.com 


Phone: (541) 344-2235 
Fax: (541) 344-2459 
email: info@saxsoft.com 
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CrypKey Software Licensing System 

"Software Copy Protection with 

NO Hardware Key and NO Disk Key" 

CrypKey is software copy protection that is: 
•completely secure from any disk copy program 
•completely compatible with MSDOS, 
MSWINDOWS, WIN95, WIN NT -16 & 32 bit 
•perfect for CD-ROM or INTERNET distribution! 
CrypKey can increase your software sales: 

• upsell options and levels of your software 

• lease or demo your software by runs or time 
•You can enable or upgrade your customers 

instantly by phone, fax, or email! 

New! unique Ready-To-Try feature: upon install 
allows 1 (and only 1) trial period per customer. 

CrypKey is produced by Kenonic Controls Ltd. 
Software and engineering since 1972. 

Kenonic Controls Limited 
7175 - 12th Street South East 
Calgary, Alberta, Canada T2H 2S6 
(403) 258-6200 fax: (403) 258-6201 
INTERNET: crypkey@kenonlc.com 
WEB: http://www.kenonic.com/crypkey.htm 
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The MFC 
Professional 


Your one stop on the Web 
for all your VC++ needs 


n c l u d e s 


Weekly Tips 
MFC Source Code 
1000+ Archived Threads 
Registry of Professionals 
Interactive Discussion Groups 
Shareware / Freeware 
Product Listings 
all free! 

http://www.visionx.com 


CAREER OPPORTUNITIES 
NATIONWIDE 
$40,000 - $120,000 


. Windows' 3.X, NT, Win 95 
. Network Programming Tools 

• C, C++ 

• Visual Basic Tools 

• Powerbuilder 
.Delphi/ORACLE/GUI 
. Many other computer 

disciplines served 

Ansara, Bickford & Fiske 


The Computer Specialists 

Contact Mr. Peter Kratimenos 
P.O. Box 239, W. Spfld., MA 01090 
Tel (413) 733-0791 Fax (413) 731-1208 
See Our Web Site at: 
http://www.ansara.com 
e-mail: pk@ansara.com 
2,000 Affiliates Worldwide 
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Developer Jobs! 

Internet: ngi@scientific.com 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
R&D jobs for software engineers, SQA, prod¬ 
uct managers, etc. Nationwide contacts with 
both large and small companies including 
start-ups. Many clients develop commercial 
software products. Most develop for Win¬ 
dows, NT, Macintosh, OS/2, and Unix based 
platforms. We also recruit in other leading 
edge technology areas such as PDA, low level 
and real-time, compilers, etc. Managed by 
graduate engineers. Send resume or call for a 
marketability assessment. Never a fee. 

Scientific Placement, Inc. 
800-231-5920 Fax 800-757-9003 
http://www.scientific.com 

Corapuserve:71250.3001 AOLrdavesraall 
SP18, Box 19949. Houston, TX 77224 
713-496-6100 Fax:713-496-0373 
SPI8. Box 71. San Ramon. CA 94583 
510-733-6168 Beth@spica.bdtcora 
SPI8, P. O. Box 202676. Austin. TX 78720-2676 
512-331-0302 lej@zilker.net 
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Embed 

Intelligence 


Endow your C/C++ apps with 
advanced rule-based features by 
embedding Prolog-defined sub¬ 
programs using the world’s finest 
and fastest Prolog compiler: 

ALS Prolog 

Create your subprograms using 
the ALS environment, and then 
embed using the DLL! 



Check it all out at 

http://www.als.com 


Applied Logic Systems, Inc. 


P.O. Box 180 (617)965-9191 

Newton Centre, Fax: 965-1636 

MA 02159 USA info@als.com 
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Port your Windows 3.x drivers to 
Windows 95 and NT. 


We have over 4 yrs experience in 
developing Device drivers for 

• Barcode Scanners 

• Network Cards 

• IRDA Devices 

• Serial Communications 


Infosolv Inc. 

(800) 775-7658 
info@infosolv.com 


Visit us at li(l|>:/Av\i\i.infosolv.coin 
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C++ tc HTML And 
RTF Cccwmoemt&ticio 

Object Outline extracts comments directly from source 
code. Requires no source changes or ugly comment tags. 
Combine external design documents, source code, and 
comments into a single, coherent, up-to-date document. 
Automatic hyper-linking. Integrate into an internal WWW 
project page. Works with all the major 32-bit Window compilers. 

Visit us on the web for a working demo and 
samples. Windows 95 and NT 3.51—$297. 

Order by calling 1-800-214-4746, 
fax an order to 1-800-657-8141 
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Market and 
Publish Software! 


WishBone Publishing, Inc. seeks software 
products to publish in the marketplace, 
if you have developed an innovative and 
creative game, program or utility, 
WishBone will review your program, 
determine its market potential, and 
publish the finished product. 

WishBone 

PUBUSHINGJN^ 

110117th Street, N.W., Suite 408 
Washington, D.C. 20036 

Telephone:202-331 -9789 
Toll Free: 800-982-2578 
Fax:202-872-0286 
V http://www.wbonepub.com y 
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Windows NT Drivers 


Development 

Consulting 

Training 

by the best in the industry 


> File Systems 
• NDIS Drivers 


> Kernel Mode Drivers 

> Systems Internals 



Open Systems Resources, Inc. 
105 Route 101 A, Suite 19 
Amherst, NH 03031 
(603) 595-6500 — info@osr.com 


Call or email for a free no obligation quarterly subscription to 
The NT Insider , the world’s only newsletter dedicated entirely 
to Windows NT systems software development! 
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Web Page: http://www.bluewatersystems.com 
HASSLE FREE HARDWARE CONTROL 

I Version 2.0l 



InRT 


New Features: 
•Script 


■if ■ else 
-whiled 
•Arrays 
•Faster 
Execution! 
•Avg.15% 


Windows95'"-w—■ 


Win32* 


♦-NT™ 


Binary Compatible 

Spend your time writing your App...not 
wading through D.D.K. documentation! 
Fast hardware control under Win32 1 
without the device driver kit! 

V Port I/O / Memory I/O V Interupts 
OCX version also available 
Ask us about Alpha™, PowerPC™ & MIPS versions 
NO RUNTIME ROYALTIES 

VISA, MC, AMEX & Approved P.O. accepted 
Tel (206)771-3610 • Fax (206)771-2742 
E-Mail: info@bluewatersystems.com 

(800)962-2114 _ 
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You're right — we should have explicit¬ 
ly said "DOS only." After a few hours of 
editing all that low-level hardware stuff, I 
guess I was unable to see the forest for the 
trees. Thanks for pointing this out! —rib 


From: dxc@mitron.com (David 
Callaway) 

Subject: vc++4.2 stl 

Microsoft now actually supports 
rather than "supports" (includes on the 
CD, you port it) the STL. Due to a defi¬ 
ciency in their compiler, you must do this 

vector<int.a11ocator<int> > xxx; 

instead of 


vector<int> xxx; 

I sure didn't understand their explana¬ 
tion for this. Search for "workaround" 
in the help to find it. Note this: 

vector<int,allocator<int>> xxx; 


will not work. I think this is a conse¬ 
quence of Stroustrup's fetish for not 
adding reserved stuff. Why, one might 
ask, is it okay to overload '<' and '>' in 
the template stuff, but not '»'? If you 
must add the allocator<int> in to make it 
work, why can't the compiler do it for 
you? 


Is this a bug or a feature? 

Also of interest: as of 4.2, VC++ apps 
will no longer run under Win32s. If you 
insist, they include v4.1 and Win32s, 
and you are welcome to do a separate 
install under a different user account to 
build 4.1 apps that will (may? in our 
experience) run under Win32s. 

VC++ appears to run okay under 
NT beta2.1 found this out after a week- 
end-long ordeal installing it over 3.51. 
Among other things, it corrupted my 
registry (not to be restored by the emer¬ 
gency disk, we add) while in Control 
Panel. Even after all the pain, though, it 
seems nice. It's faster and the interface 
is better. That registry bomb (upon can¬ 
celling in the dialog to change swap file 
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Opt-Tech Sort/Merge 


^ New-Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
Win95, OS/2, UNIX $249 
Call to order or for free info. 


Opt-Tech Data Processing 

P.O. Box 678 
Zephyr Cove, NV 89448 

, ( 702 ) 588-3737 j 
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Report woes? 

Slow, large, impossible? 


PrintForm 

Create complex, impossible reports. 

High quality documents, very well suited 
for form letters, reports and tables. Icons, 
bitmaps, texts. Fonts, word-wrapping, ali¬ 
gnment, headers, footers, numbering. DLL 
and C++ API. Demos in CompuServe: 
MSMFCcrMSBASIC 

DLL and source versions, 16- and 32-bit. 
30 day money-back guarantee. 

Cobasoft GmbH: CIS: 100010,204, Tel: +49-177-2194647 
Griffin Technologies Inc.: 800-986-6578,913-832-2070, 
Fax: 913-832-8787, CIS: 71141,3624. 

□ Request Reader Service #168 i 


C and C++ DOCUMENTATION 


!! VERSION 6.2!! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates comment- 
blocks for each function, listing the functions 
and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, counts 
comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, or 
reformats into standard formats. 

• C-REF ($69) Creates cross-reference of local/ 
global/define/parameter identifiers. 

• C-D0C ($199) Package All 5 programs integrated 
as DOS program. <10,000 lines. 

V6.0 C-BR0WSE Windows graphic-tree viewer. 

• C-D0C Professional ($299) DOS, Windows, OS/2. 
3-ring binder/case. <1,000,000 lines. 

30-DAY Money-back guarantee. CALL NOW! 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga Voice/Fax (905) 858-4466 
0NT Canada L5N-4M1 http://www.swbs.com 


Please see Ad Index for our larger ad. 
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S/W ENGINEERING POSITIONS NATIONWIDE 


We Understand 
Programmer's 
Mind* 


When the country's 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows. NT. OS/ 

2 and Macintosh re¬ 
cruiting nationwide. 

So if it's time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 

It Bateman Inc. 

5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax: 310-641-2900 
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* ProMath/VB - numerics/statistics. $149 

* FinLib/VB - financial calculations. $149 

* SpellCheck/VB - spelling & lookup. $49 

* Dazzle/VB - image manipulation. $199 

* VBIite -print/comm/array/B-Tree index..$J49 

* VoxLib/Pro - telephony (multi-line) ...$799 


* QB/C/dBase - 15 more DOS libraries ...$call 

* Custom - C, VB, ASM programming ,...$80/h 
Develop your VB app faster: Get TeraTech tools! Call, E-mail 
or fax us and well mail you a free demo disk ASAP, Or for 
faster service download by FTP or from our BBS. Call now! 

800-447-9120 ext. 1206 

Dept. 1206. 100 Park Avenue. Suite 360. Rockville. MD 20850 USA 
Infl: +1-301-424-3903 Fax: (301) 762-8185 BBS: (301) 762-8184 
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Demo / Tutorial / CBT / Presentation 


Visual Windows Automation 
Multimedia Authoring Development Kit 

Q Use ShowBasic Recorder to generate the editable, 
mouse/keyboard simulation code invariant to window's 
size and position, screen resolution and video driver. 

Q Achieve visual control over external applications 
and unlimited flexibility by programming in full 
featured Basic extended with the unique presentation 
and CBT related functionality, use even access to 
external DLLs and Windows™ 16-bit or 32-bit API. 

Q Pack your application in a compressed executable 
with the small self-installed run-time and all supporting 
files (BMP, WMF, WAV, MIDI, AVI), compatible with 
Windows 3.1, Windows 95 and Windows NT . 

Q Deliver your titles transparently via WWW - 
ShowBasic can be integrated with any WEB browser. 

Development license SW with .V> day money back guarantee. Royalty free license SXV.V 

If you don't need all the pow er of Show Basic - use our simple, 

yet flexible scripting language for live demos and automation: 

SaTnEMEJEVStO -fFP TT- 

Single-user license $30 ($60 Pro), Royalty free license $300 ($.VKI Pro). Visa/MC accepted. 

Find more information, demos, samples and evaluation copy: 

http://www.cnj.digex.net/~mik 

B MIKSoft, Inc. tel/fax: 908-390-8986 

37 Landsdowne Road. East Brunswick NJ. 08816 
Internet: mik@cnj.digex.net CompuServe: 74127.3671 
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J-As 


ZIP 


XCEED ZIP 

COMPRESSION LIBRARY 


16 and 32-bit Delphi VCLs, VBX, OCX 


Finally, a compression component that 
gives you your money's worth! Add 
Xceed Zip to your project, set a few 
properties, and your apps will be ziping 
and unziping in minutes. Great for 
automating backups, preparing files 
for transmission, or developing your 
own custom installer. 



( 800 ) 865-2628 
( 614 ) 442-2626 


Visit www.xceedsoft.convdev for a 
free trial version and find out 
why Xceed Zip is rapidly becoming 
the most popular VB and Delphi 
compression library! 
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, w Cash in on 
i the Voice 
^ Bonanza! 


Get your piece of the $3 billion Voice Industry - 
develop your own Computer Telephony Apps! 


Add voice power 
to your Windows 
apps with TI/F 
DLL ” (CT Mag's 
Product of the 
Year), our popular 
interface to 
Dialogic™ multi- 
line telephony 
hardware. 


Audio ToolBox" 
lets you batch 
process and 
convert audio files 
to & from standard 
formats. Adjust 
volume, filter, trim 
silence, more! Add 
to your apps with 
ToolBox SDK. 


Call and ask about 
our VFEdif 
professional voice 
prompt editor. 
Scribe ™ trans¬ 
cription utility. 
Vox Fonts" text- 
to-speech library, 
plus more great 
products! 


800-469-4874 


VISI, 2118 Wilshire Blvd, #973, Santa Monica, CA 90403 
310-392-8780 Fax: 800-234-FXIT / 310-392-5511 sales@vinfo.com 
BBS: 310-392-6610 www.vinfo.com (Download Working Demos) 
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Port I/O on NT/95 


DriverX, 

Hardware control library/OCX 

Easily create custom hardware 
interfacing using VB4, C/C++, or Dephi. 
No VxD or NT driver development 
required. Binary portability between 
Windows 95 and NT. Royalty free 
redistribution and Hardware Viewer 
utility. Starting at only $249. 



WinStar 


Technologies 


(408) 377-6367 
wintech@interramp.com 


visit us at http://www.wintech.com 
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PROGRAMMERS... 

$100k/yr at HOME! 


My new book, "How To Make $100,000 A 
Year And More Developing Low Budget 
Software Products", will reveal all the 
marketing tricks, strategies, and systems that 
have my business exploding with PROFITS! 

Add your skills to my proven strategies and 
you have the PERFECT BUSINESS ... Low 
overhead, part-time, home-based, huge 
margins, and UNLIMITED POTENTIAL . 


CALL 800-364-4883 


Call TODAY for a FREE special report! 
ULTRA _ Fax: 214-724-0375 

Financial Systems CompuServe: 71223,634 

1633 Arrowhead Dr, Rower Mound, TX 75028 
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www.dice.com 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-9600 
baud Modem, 8-N-l. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 
Web 


408-737-9339 
404-523-1341 
708-782-0960 
515-280-3423 
617-266-1080 
201-242-4166 
214-691-3420 
telnet dice.com 
www.dice.com 


DATA PROCESSING 
I NDEPENDENT 

Consultant's! 

E XCHANGE . 


A Service of D&L Online, Inc:. (515) 280-1144 
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MFC 3D Modeling Extensions 

Need to add 3D modeling capabilities to your 
new or existing MFC based products? MEX 
is a full featured, robust, no compromise 3D 
modeling application framework featuring: 
Object/Tool/Editor architecture 
Extensive math library 
Orthographic and Perspective views 
Import/Export facilities 
Unlimited Undo/Redo 
2D/3D Bezier Spline editor 
Mesh/Light/Camera editor 
Generalized Cylinder editor 
And much, much more. Windows 95/NT 
All four modules only:$149 (Personal) 
Call today: 914-267-2059 
Source Available Visa/MC/COD 

B&F Software Solutions Inc. 

44 FoKim Way Congers, NY 10920 
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Dr. 

ODBC Tools 

Tools for ODBC development 

Ever wonder why 
your ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 


Dr. DeeBee ODBC Driver Kit 


Connect proprietary databases to 
Access, Visual Basic, and PowerBuilder 
with our Dr. DeeBee ODBC Driver Kit 




-SYWlflEZ - 

RO. Box 91 Kendall, Cambridge, MA 02149 
617 - 497-1376 Fax 617-497-8729 
http://www.syware.com 
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size) really sucked. I had to wipe it out 
down to the bare metal (bye bye, all 
you 3.51 installs, I wanted to do it again 
anyway) to get it back up. 

About the only thing I understand about 
templates is that accidentally typing '»' 
gives you a token you weren’t expecting 
(shift right instead of two close angle brack¬ 
ets). In my opinion, this is definitely a Good 
Thing, as the mental model required to 
understand C++ is already complicated 
enough without giving up the simple process 
of tokenization. For example, I wouldn't 
want anyone to "fix" this problem: 


void Funciint */*arg not used*/); 

// AA accidental end 

// of comment 

via some kind of operator overloading 
— better to have simple syntax prob¬ 
lems then to give them complex seman¬ 
tic fixes, in my opinion. 

I had not heard that Visual C++ 
dropped Win32s support. I feel sorry for 
all the shops using that product to main¬ 
tain 16-bit Windows applications; I guess 
Microsoft is counting on them being so 
closely tied to their compiler that they will 
be unable to port to Borland. I'm glad I'm 
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Marketplace™ 


pm 






FREE DEMO 

DOS $249 
Win 16 $299 

Win32 $299 
OS/2 $349 
Unix $349 
Macintosh $299 


The best high 
performance, 
portable 
compression 
libraries for 
DOS, Windows, 
OS/2, Unix, 
Macintosh, 
embedded systems, 
and practically anything 
else, period. 

45-function API 
Buffer compression 

E:U .- 


File compression 
Disk spanning 
Encryption 
Self-extracting EXE's 
VBX/OCX controls 
On-line help 
Full source code 


ES DC Micro Tel 606-268-1559 

SS Development Fax 606-266-0/26 

Call 1-800-775-1073 

info@dcmicro.com http://www.dcmicro.com 




StarMaker Systems Inc. 

f 173 Thomson Ave., Regina, SK 
^ Tel: (306) 596-2575 
www.starmaker-systems.com 


StarTools™ are quality utilities for 
Windows and Paradox developers. 

Available NOW - get your copies today! 

StarTime - FREE ! network PC time synchronizer. 
StarCLID - PC Interface for TelCo Caller ID data. 
LoadStar - checks PC configuration & pre-installed 
programs before allowing new program to install. 

Available 4Q’96- reserve your copy now! 

StarDate - perpetual calendar with library connection to 
Paradox application forms. 

Captains Log - journal logging of application table 
changes. Full audit trails. Perfect for disaster recovery. 
StarLicence - counts & controls number of licensed 
users on networked PCs. 

StarLock - provides a lock for one or more Windows 
program groups for unattended PCs. Great for shows. 
StarSecure - provides excellent security & multi-layer 
user access for Paradox application forms & tables. 
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CC-RIDER 


C and C++ 

■=- BROWSING 
FOR ANY EDITOR! 

Source Code Analysis and Documentation 


EMe EdN View Wh<d»w I«ol« Qp«on» Help 




NEWV5.1for Win 3.1, NT, DOS & OS/2 

Western Wares 

Free Demo (970) 327-4898 
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able to write vendor-independent code 
most of the time, so I can easily switch to 
whichever vendor does the best job for me. 
Application frameworks are great, but I'll 
do my best to never use MFC unless it's 
shipping with Borland's compiler, too — 
you just can’t tell what Microsoft will or 
won't support in the future. —rib 


DISKETTE & 
CD DUPLICATION 


Let us send out your Demo Disks 

• DISK DUPLICATION 

• LABELS/DISK & CD 

• CD DUPLICATION 

• FULFILLMENT 

• BLANK MEDIA 
• LOW PRICES 

• FAST TURNAROUND 

DUPLICATION TECHNOLOGIES, LTD. 
P.O. BOX O, WELLINGTON, MO 64097 
TOLL FREE (888) 899-3475 
PHONE (816) 934-8518 FAX (816) 934-2590 
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Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 


Reach the core of the 
Windows programming market: 

Windows 

□ DEVELOPER S JOURNAL 

The Magazine for Windows Programmers 

Call 913 - 841-1631 today 

for information about 
advertising opportunities in 
Windows Developer's Journal. 


I Ed MacMillan - East I Julie Thornton - West 
913-838-7513 I 913-838-7541 

I breakout! marketing - Continental Europe 
+49 431-801740 


November 1996 


















































Versions 

Av ailable 



yet# 0 '' 

6*0 


HIGH PERFORMANCE 


CONVERSION 


SCALE-TO-GRAY 


IMAGE PROCESSING 


FAST DISPLAY 
COMPRESSION 


and more! 


The Best Imaging Toolkit - Is Now Even Better! 


AccuSoft Corporation announces a totally new product, 
ImageGear," the next generation in imaging technology. 
ImageGear, the new version of the AccuSoft Image 
Format Library”, is more than just an upgrade, it is a 
whole new level of the quality and 
performance that has made AccuSoft the 
leading supplier of imaging toolkits. Just 
for starters, we redesigned all the image 
filters to add several new features to 
ensure that our support for image 
formats is by far the most comprehensive. We even 
added file-info executables for every format we 
support - and, of course, we added several new 
formats. 

ImageGear has a new and improved API that makes 
integration even easier, plus many new features 



including totally redesigned display functions for faster 
image display, sub-pixel accuracy, transparency, and an 
automatic image window with many built-in features. 
We also added new GUI functions including a 
comprehensive thumbnail browser, pan and 
zoom windows, magnifying glass, page 
sorter and more. All with complete 
programmability. We completely 
revamped the image processing to add 
dozens of new functions and better 
In addition, we have improved the 
scanning, image compression, display effects, and just 
about everything else! 

So get into high gear with ImageGear and remember - 
the best imaging toolkit makes the best applications - 

ImageGear 6.0! 


performance. 


You can start using 
AccuSoft products 
today by taking 
advantage of our 
unique 30 Minute 
Delivery Program. 

WD2 


Two Westborough Business Park Westborough, NA 01581 Tel (508) 898-2770 FAX (508) 898-9662 

©1996 AccuSoft Corporation. All Rights Reserved. All company and brand names are trademarks or registered trademarks of their respective owners. 1 Rasteronly 2. License required from Unisys for formats using LZW compression 3. Optional 


Toll Free: (800) 525-3577 
Website: accusoft.com 


AccuSoft 

High Performance Imaging 



P\INUT£ 


Delivery 


Windows 
Win95\NT 
MIPS NT 
Alpha NT 
VBX 
OCX 
OS/2 
SUNOS 
Solaris 
HP-UX 
RS/6000 
SGI 
SCO 
MAC 

PowerMac 

Over 45 File 
Form ats 

JPEG 
TIFF 
Group III 
Group IV 
PCX 
TGA 
PGM 
DIB 
IMT 
DCX 
BMP 
KFX 
RLE 
LV 

CALS 
ATT 
CLP 
XWD 
XBM 
CIF 
IFF 
SUN 
PNM 
IOCA 
GX2 
XPM 
ASCII 
CUT 
GEM 
BRK 
MAC 
PSD 
MSP 
PNG 
PCD 
IMG 
IGF 
SGI 
ICO 
PBM 
PPM 
MO:DCA 
WMF 1 
WPG 1 
PICT 1 
EPS 1 
GIF 2 
ABIC 3 
JBIG 3 
DICOM 3 
and others 


i 



□ Request Reader Service #101 □ 




























The comprehensive imaging toolkit 


Import/export and display 
40+ image file formats 



LEADTOOLS PROFESSIONAL EXPRESS 


cSfir C »mv*r*ioit Expend ot i«duc« «n moga’o color depth with i 
emlorSbedot opUmudpol ottos StpweU/recomUuct onunagt tod 
CM Y, HSVNejjHSL color planer LEADTOOLS alro s'-ppoy^ 
rotaud stmno / « 


Display OpUmixod rendering of any mage to all i 
Iliad palette option will eliMnate the pale Ik shift a 
Riauilain the beet image quality Easy to uee ultrsn 
appheabon fly The 2J6 shade ScaleToOtay 
enhance Sm quality and readdMldy of the djft&a 




ile Form; 


txopulor raster image formate (including 
Compreeeion options See a full list at 


NEW! 
Annotation 
features include: 
add text, 
highlighter, 
sticky notes, 
ellipses, 

rectangles, lines, 
free hand 
scribbling, 
redaction, 
buttons, hot 
spots, pointers, 
audio, bitmap 
stamps, polylines, 
polygons, and 
more. 


/ Formats \_ 


BMP 

IMG 

MSP 

TGA 

CAL 

I0CA 

PCD 

TIFF 

DIB 

JPEG 

PCT 

VDA 

EPS 

JFIF 

PCX 

VST 

FAX (r 

w) JTIF 

PNG 

WINFAX 

DCX 

LEAD CMP 

PSD 

WMF 

GIF* 

MAC 

RAS 

WPG 


NEW! Progressive JPEG 


Ed* y,ew iVmdw 


, NEW LEADTOOLS 6 includes everything you need to support itrier images m your application 
> B&W documert imagirig to greyer ale imaging to Id through 16 million color desktop imaging 
IJtoottat deliver i over 200 functions to read, write, compmr, mage process, display (scroll, toons & 
l, print, r cm, & more Hew features include emotatioss region processing and support for several 

_ le formats With tie new internal modular dasigi you can salad the componenta^ou need tbs you 

specific develop mart scenasio and keep the sat of your application to a minimum 

Scantling Supports 16&32 bit TWAIN interfaces foi dnvuig the most popular semrang device* 

drthermg methods using 
ividual ROB. CMYK, 

md halftoning with 


http //www lead tools coniform at* Mm 4 

Compression No other toolkit otTers as many compression options including COT T 03 dr 04, 
CompuServe's new lossless PNO, JPEO and LEADs own prepnetary CMP LEADTOOLS delivers the 
fastest software only 1PEO algorithm* The CMP format results m smaller file sues and maintains better 
image quality than industry standard compression formats 

Printing LEADTOOLS 6 performs ell the image processing neceseary to pnnt to try printer with Ihi 
highest quality and hes the capability to pnnt test and multiple images enth* same page 




-lem 


NEW! Use region processing 
on a specific area in an image 


40+ processing 
features 
including: 

__ rotate, resize, 

crop, transpose, 
reverse, sharpen, 
blur, brighten, 
darken, hue, 
saturation, 
intensity, emboss, 
contrast, mosaic, 
posterize, line 
detect, edge 
detect, histogram 
equalize, median 
& noise filter, 
spatial filter 
(gradient, 
laplacian, sobel, 
prewitt, shift and 
difference, line 
segment), 
underlay, 
autodeskew, 
despeckle, and 
more. 


Image is everything! Take advantage of the same imaging technology 
that is utilized by Corel, AT&T, McDonnell Douglas, Xerox, Sharp, 
Delrina, Microsoft, and others! The combination of LEADTOOLS 
mature and stable code, together with the rich image processing 
features, our extensive file format support and industry leading 
compression options, makes this toolkit the only choice to integrate 
imaging into your application. Whether you choose one of the 
LEADTOOLS Pros or LEADTOOLS Pro Express, you are guaranteed 
the most comprehensive imaging solution available! 

The award-winning LEADTOOLS 6 is everything developers need to 
integrate black & white, grayscale, and color images into any 
WIN 16/32 or OS/2 application. Our toolkits provide 200+ functions, 
with the following capabilities: importing and exporting of 40+ file 


formats, rich image processing, region of interest, color conversion, 
fast image compression, scrolling, zooming, dithering, printing, 
scanning, data base support and annotations. With our new internal 
modular design, you can select the components you need for your 
specific development scenario and keep the size of your application to 
minimum. The toolkits provide both high-level and low-level 
functions, and ships with example application source code. 

If you need imaging, you need LEADTOOLS. 


"LEADTOOLS is an indespensable tool - we 


“LEADTOOLS is a fine example of excellent 

used it in the development of our FrontPage 


technical skills, marketing, and good design 

application. ” 


combining to make an excellent tool. 


• Tom Button, Director of Marketing, 
Internet Platform & Tools Division, 
Microsoft Corp., 7/96 


- Don Rogers, 

VB Tech Journal, 
June, 1996 


Download FREE 
imaging application built with 
NEW LEADTOOLS 6! 
or call 

800 - 637-1847 


WINDOWS 95 

1 WINDOWS NT 

J WIN32S 


WINDOWS 

OS/2 

DOS 




VBX 

OCX 16/32 

DLL 16/32 


Everything You Need To Know About Imaging 


http://www.leadtools.com/ 



900 Baxter St. Charlotte, NC 28204 704-332-5532 Fax: 704-372-8161 CompuServe: 'GO LEADTECH" 
LEADTOOLS is available in severol versions, not all features are available in all versions. 

' license required (torn Unisys tor fornots using LZW compassion HAD ond LEADTOOLS on legtsMed irademorb of LEAD ledmologm, Inc All atw product nomes on fiodemorks of then respective owneis 
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C/C++ 

MFC 

1 VISUAL BASIC 


ACCESS 

DELPHI 

VISUAL FOXPRO 

















































































